EVALSHA_RO(3valkey)

💖 EVALSHA_RO — bestie edition 💖

okay so. <rainbow>evalsha_ro</rainbow> from the 3valkey manual. it's the read-only girlie of the Lua script world, and she will be serving. let's get into it ✨

---

✨ NAME ✨

evalsha_ro — Executes a read-only server-side Lua script by SHA1 digest. 🎀

---

🌸 SYNOPSIS 🌸

EVALSHA_RO sha1 numkeys key [key...]  arg [arg...]

---

🦋 DESCRIPTION 🦋

so basically? this is a read-only variant of the valkey-evalsha(7) EVALSHA command. the whole vibe is that it cannot execute commands that modify data. it's giving "look but don't touch" and honestly? iconic 💅

for more info about when you'd reach for this command vs plain EVALSHA, go read valkey-programmability(7) → Read-only scripts. that's where the lore lives, bestie.

and for more info about EVALSHA scripts in general, check valkey-eval-intro(7) → Introduction to Eval Scripts. slay.

---

💜 REPLY 💜

the return value depends on the script that was executed. so like... it's whatever the script says it is. mystery, but make it documented 🌈

---

🧚 COMPLEXITY 🧚

Depends on the script that is executed. yeah we know, very "depends on the script" of it. that's the whole point though 💀

---

👑 ACL CATEGORIES 👑

• @scripting
• @slow

---

⭐ HISTORY ⭐

• Available since: 7.0.0 — so she's a 7.0.0 era baddie 🫶

---

🌈 SEE ALSO 🌈

• eval(3valkey)
• evalsha(3valkey)
• eval_ro(3valkey)
• fcall(3valkey)
• fcall_ro(3valkey)
• function(3valkey)
• function-delete(3valkey)
• function-dump(3valkey)
• function-flush(3valkey)
• function-help(3valkey)
• function-kill(3valkey)
• function-list(3valkey)
• function-load(3valkey)
• function-restore(3valkey)
• function-stats(3valkey)
• script(3valkey)
• script-debug(3valkey)
• script-exists(3valkey)
• script-flush(3valkey)
• script-help(3valkey)
• script-kill(3valkey)
• script-load(3valkey)
• script-show(3valkey)

---

okay that's the whole page, no cap. this was EVALSHA_RO(3valkey) from the Valkey Command Manual, version 9.0.0, dated 2025-10-21. ily, go run a read-only script responsibly 💖✨🦋