CXXIII. Fonctions runkit

Introduction

L'extension runkit fournit les moyens de modifier les constantes, les fonctions et les classes définies par l'utilisateur. Elle fournit aussi ces moyens pour les variables superglobales et les sous-interpréteurs par sandboxing.

Des informations comme les notes sur les nouvelles versions, les téléchargements, les sources des fichiers, les informations concernant les mainteneurs ainsi qu'un CHANGELOG, peuvent être trouvées ici : http://pecl.php.net/package/runkit.

Ce paquetage est signifié en tant que remplacement de fonctionnalités pour le paquetage classkit. Lorsque compilé avec l'option --enable-runkit=classkit à ./configure, les définitions des fonctions et des constantes de classkit seront exportées.

Pré-requis

Modification de Constantes, Fonctions, Classes et Méthodes fonctionne avec toutes les versions de PHP 4 et PHP 5. Aucune condition spéciale n'est nécessaire.

Les Superglobales Personnalisées sont seulement disponibles dans les versions PHP 4.2.0 et supérieures.

Sandboxing nécessite PHP 5.1.0 ou supérieur ou PHP 5.0.0 avec le patch spécial TSRM appliqué. Sans se soucier de quelle version de PHP est utilisé, sandboxing doit être compilé avec l'option --enable-maintainer-zts. Voyez le fichier README dans le paquetage de runkit pour plus d'informations.

Superglobales personnalisées

L'option ini runkit.superglobal devrait être écrite avec une liste de nom de variables séparées par des virgules pour que celles-ci soient traitées en tant que superglobales. Cette valeur devrait être écrite dans le fichier php.ini global, mais devrait fonctionner dans les configurations locales de votre SAPI.

Exemple 1. Superglobales personnalisées avec runkit.superglobal=_FOO,_BAR dans php.ini


<?php
function show_values() {
  echo "Foo est $_FOO\n";
  echo "Bar est $_BAR\n";
  echo "Baz est $_BAZ\n";
}

$_FOO = 'foo';
$_BAR = 'bar';
$_BAZ = 'baz';

/* Affichage de foo et bar, mais pas baz */
show_values();
?>

Constantes pré-définies

Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.

RUNKIT_IMPORT_FUNCTIONS (entier): runkit_import() marque indiquant que les fonctions normales doivent être importées à partir du fichier spécifié.
RUNKIT_IMPORT_CLASS_METHODS (entier): runkit_import() marque indiquant que les méthodes de classes doivent être importées à partir du fichier spécifié.
RUNKIT_IMPORT_CLASS_CONSTS (entier): runkit_import() marque indiquant que les constantes de classes doivent être importées à partir du fichier spécifié. Notez que cette marque est seulement signifiante dans les versions PHP 5.1.0 et supérieures.
RUNKIT_IMPORT_CLASS_PROPS (entier): runkit_import() marque indiquant que les propriétés standards de classes doivent être importée à partir du fichier spécifié.
RUNKIT_IMPORT_CLASSES (entier): runkit_import() marque indiquant une opération de bits OU (OR) des constantes RUNKIT_IMPORT_CLASS_*.
RUNKIT_IMPORT_OVERRIDE (entier): runkit_import() marque indiquant que si n'importe quelles fonctions, méthodes, constantes ou propriétés importées existent, elles doivent être remplacées par leurs nouvelles définitions. Si ce drapeau n'est pas activé, alors toutes définitions importées qui existent déjà seront supprimées.
RUNKIT_ACC_PUBLIC (entier): Drapeau spécifique à PHP5 pour runkit_method_add()
RUNKIT_ACC_PROTECTED (entier): Drapeau spécifique à PHP5 pour runkit_method_add()
RUNKIT_ACC_PRIVATE (entier): Drapeau spécifique à PHP5 pour runkit_method_add()
CLASSKIT_ACC_PUBLIC (entier): Drapeau spécifique à PHP5 pour runkit_method_add() Seulement définie lorsque les compatibilités classkit sont activées.
CLASSKIT_ACC_PROTECTED (entier): Drapeau spécifique à PHP5 pour runkit_method_add() Seulement définie lorsque les compatibilités classkit sont activées.
CLASSKIT_ACC_PRIVATE (entier): Drapeau spécifique à PHP5 pour runkit_method_add() Seulement définie lorsque les compatibilités classkit sont activées.
CLASSKIT_AGGREGATE_OVERRIDE (entier): Drapeau spécifique à PHP5 pour classkit_import() Seulement définie lorsque les compatibilités classkit sont activées.
RUNKIT_VERSION (chaîne de caractères): Définie la version courante du paquetage runkit.
CLASSKIT_VERSION (chaîne de caractères): Définie la version courante du paquetage runkit. Seulement définie lorsque les compatibilités classkit sont activées.

Table des matières
Runkit_Sandbox -- Classe Runkit Sandbox -- Machine Virtuelle PHP
runkit_class_adopt -- Convertit une classe de base à une classe héritée, ajoute une méthode ancestrale lorsque approprié
runkit_class_emancipate -- Convertit une classe héritée à une classe de base, supprime toute méthode pour qui la portée est ancestrale
runkit_constant_add -- Similaire à define(), mais permet aussi la définition dans définitions de classe
runkit_constant_redefine -- Redéfinit une constante déjà définie
runkit_constant_remove -- Enlève/Supprime une constante déjà définie
runkit_function_add -- Ajoute une nouvelle fonction, similaire à create_function()
runkit_function_copy -- Copie une fonction vers un nom de fonction nouveau
runkit_function_redefine -- Remplace une définition de fonction avec une nouvelle implémentation
runkit_function_remove -- Enlève une définition de fonction
runkit_function_rename -- Change le nom d'une fonction
runkit_import -- Traite un fichier PHP important fonctions et définitions de classes, écrasement où applicable
runkit_lint_file -- Vérifie la syntaxe PHP d'un fichier spécifié
runkit_lint -- Vérifie la syntaxe PHP de code PHP spécifié
runkit_method_add -- Ajoute dynamiquement une nouvelle méthode à une classe donnée
runkit_method_copy -- Copie une méthode d'une classe à une autre
runkit_method_redefine -- Change dynamiquement le code de la méthode donnée
runkit_method_remove -- Supprime dynamiquement la méthode donnée
runkit_method_rename -- Change dynamiquement le nom de la méthode donnée
runkit_sandbox_output_handler -- Spécifie une fonction à capturer et/ou traiter la sortie à partir d'un runkit sandbox
runkit_superglobals -- Retourne un tableau indexé numériquement des variables superglobales enregistrées