0Pricing
Lua Academy · Leçon

Le modèle _ENV de Lua 5.2+

Comprenez comment _ENV a remplacé setfenv et permet de contrôler l’environnement.

Le modèle _ENV de Lua 5.2+ est une leçon Lua Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Lua Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Lua Academy comprend 4 leçons au total.

Qu’est-ce que _ENV ?

Dans Lua 5.2 et les versions ultérieures, chaque bloc de code possède une variable externe implicite appelée _ENV. Tous les accès aux variables globales sont réécrits en accès à des champs de _ENV. Ainsi, print(x) devient _ENV.print(_ENV.x).

_ENV remplace setfenv

Dans Lua 5.1, setfenv(fn, env) modifiait l’environnement global d’une fonction. Cette fonction a disparu à partir de la version 5.2. À la place, définissez _ENV comme variable locale pour modifier l’environnement d’un bloc de code ou d’un bloc.

Modifier _ENV dans un bloc de code

Définissez _ENV au début d’un bloc de code pour rediriger tous les accès aux variables globales.

-- Everything in this chunk uses myEnv as globals
local _ENV = myEnv
print("hello")  -- calls myEnv.print("hello")

_ENV local pour un bloc

Limitez la portée des modifications de _ENV à un bloc do...end afin d’en limiter l’effet.

do
  local _ENV = {print = print, x = 42}
  print(x)  -- 42 from local _ENV
end
print(x)  -- original _ENV.x (global x)

Utiliser load avec _ENV

load(chunk, chunkname, mode, env) exécute une chaîne comme un bloc de code avec un environnement personnalisé. Il s’agit du principal mécanisme de bac à sable dans Lua 5.2 et les versions ultérieures.

local env = {print = print, math = math}
local fn, err = load("print(math.sqrt(16))", "sandbox", "t", env)
if fn then fn() end  -- 4.0

Lecture de l’_ENV actuel

Les variables globales du bloc de code actuel se trouvent dans _ENV. Pour obtenir une référence : local myEnv = _ENV.

Modifier _ENV à l’exécution

La définition d’une variable globale s’écrit _ENV.varName = value. Comme _ENV est une variable externe, vous pouvez la remplacer par une autre table à tout moment dans le code.

Héritage avec __index

Donnez à l’environnement du bac à sable une métatable contenant __index = _G pour utiliser en repli la véritable table globale pour les fonctions que vous n’avez pas explicitement bloquées.

local sandboxEnv = setmetatable({}, {__index = _G})
-- then block dangerous ones:
sandboxEnv.os = nil
sandboxEnv.io = nil
sandboxEnv.load = nil

Détection des tentatives d’accès à _ENV

Remplacez les variables globales dangereuses par une valeur sentinelle qui consigne les tentatives d’accès à des fins d’audit de sécurité.

sandboxEnv.os = setmetatable({}, {
  __index = function(_, k)
    ngx.log(ngx.WARN, "Blocked access: os." .. k)
    return nil
  end
})

Remarque sur la compatibilité

Les bibliothèques qui utilisent setfenv/getfenv de Lua 5.1 doivent être réécrites pour Lua 5.2 et les versions ultérieures. Certaines utilisent une couche de compatibilité dans le code d’initialisation.

Conséquences pratiques

Le modèle _ENV rend la mise en bac à sable plus claire et plus cohérente. Il existe un mécanisme unique et explicite pour les environnements, au lieu de deux (setfenv pour les fonctions et les variables globales pour le niveau supérieur).

Question sur _ENV

Comment Lua 5.2 et les versions ultérieures réécrivent-elles l’accès global print(x) ?

Récapitulatif : modèle _ENV

Lua 5.2 et les versions ultérieures font passer tous les accès globaux par la variable externe _ENV. Utilisez load(code, name, "t", env) pour exécuter du code dans un environnement personnalisé. Il s’agit du mécanisme standard de mise en bac à sable qui remplace setfenv.

Questions Fréquemment Posées

La leçon « Le modèle _ENV de Lua 5.2+ » est-elle gratuite ?

Oui — le texte complet de « Le modèle _ENV de Lua 5.2+ » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Lua Academy, passe à CoddyKit PRO. Le cours Lua Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Le modèle _ENV de Lua 5.2+ » ?

Comprenez comment _ENV a remplacé setfenv et permet de contrôler l’environnement. Tu pratiques Lua Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Lua Academy ?

Aucune expérience préalable n'est requise. Lua Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.

Combien de temps prend la leçon « Le modèle _ENV de Lua 5.2+ » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Lua Academy ?

Oui. Chaque leçon Lua Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. Le modèle _ENV de Lua 5.2+
  2. Construire un bac à sable restreint
  3. Empêcher les sorties du bac à sable
  4. Limites de ressources et instrumentation
← Retour à Lua Academy