Options / Informations PHP

Question 1

mixed assert_options ( int $what [, mixed $value ] )

Answer 1

assert_options() permet de modifier les diverses options de la fonction assert(), ou simplement connaître la configuration actuelle.

Question 2

bool assert ( mixed $assertion [, string $description ] )

Answer 2

assert() va vérifier l’assertion assertion et prendre la mesure appropriée si le résultat est FALSE.

Si assertion est donnée sous la forme d’une chaîne, elle sera évaluée comme un code PHP par la fonction assert(). Les avantages de ce type d’assertion sont d’être moins lourd si la vérification d’assertion est désactivée, et les messages contenant l’assertion lorsque l’assertion échoue. Cela signifie que si vous passez une condition booléenne en tant qu’assertion, cette condition ne sera pas considérée comme un paramètre par la fonction d’assertion que vous avez définie avec la fonction assert_options(), la condition est convertie en chaîne de caractères avant l’appel à ce gestionnaire de fonction, et le booléen FALSE sera converti en chaîne de caractères vide.

Il est recommandé de n’utiliser les assertions que comme outil de déboguage. Vous pouvez les utiliser pour les vérifications d’usage : ces conditions doivent normalement être vraies, et indiquer une erreur de programmation si ce n’est pas le cas. Vous pouvez aussi vérifier la présence de certaines extensions ou limitations du système.

Les assertions ne doivent pas être utilisées pour faire des opérations de vérifications en production, comme des vérifications de valeur d’argument. En conditions normales, votre code doit être en état de fonctionner si la vérification d’assertion est désactivée.

Le comportement de assert() peut être configuré par assert_options() ou par les directives de configuration décrites dans la page de manuel de cette fonction.

La fonction assert_options() et la directive ASSERT_CALLBACK permettent de configurer une fonction qui sera appelée lorsque l’assertion échoue.

Les fonctions de rappel pour assert() sont particulièrement utiles pour bâtir des suites de tests automatiques, car elles vous permettent de capturer facilement le code passé à l’assertion, ainsi que des informations sur le lieu et le moment de l’assertion. Même si ces informations peuvent être appelées par d’autres méthodes, les assertions sont plus rapides et plus faciles.

La fonction de rappel doit accepter trois arguments. Le premier contient le nom du fichier qui a vu l’assertion échouer. Le second contient le numéro de ligne dans le fichier précédent. Le troisième argument contient l’expression qui a échoué (s’il y en a : les valeurs littérales — comme 1 ou “deux” ne seront pas passées par cet argument). Les utilisateurs de PHP 5.4.8 ou supérieur peuvent également fournir un quatrième argument optionnel, qui contiendra la description fournie à la fonction assert(), s’il est défini.

Question 3

string cli_get_process_title ( void )

Answer 3

Retourne le titre du processus courant, tel que défini par la fonction cli_set_process_title(). Notez que ce titre peut être légèrement différent de celui affiché via les commandes ps et top, suivant le système sous-jacent.

Cette fonction n’est disponible qu’en mode CLI.

Question 4

bool cli_set_process_title ( string $title )

Answer 4

Définit le titre du processus visible avec des outils comme top et ps. Cette fonction n’est disponible qu’en mode CLI.

Question 5

bool dl ( string $library )

Answer 5

Charge l’extension PHP library à la volée.

Utilisez la fonction extension_loaded() pour vérifier qu’une extension est chargée ou non. Cette fonction travaille aussi bien avec les extensions natives qu’avec les extensions dynamiquement chargées (via le php.ini ou dl()).
Avertissement

Cette fonction a été supprimée du SAPI en PHP 5.3.

Question 6

bool extension_loaded ( string $name )

Answer 6

Détermine si une extension est chargée ou non.

Question 7

int gc_collect_cycles ( void )

Answer 7

Force le passage du collecteur de mémoire

Question 8

void gc_disable ( void )

Answer 8

Désactive le collecteur de références circulaires, en configuration zend.enable_gc à 0.

Question 9

void gc_enable ( void )

Answer 9

Active le collecteur de références circulaires, en définissant zend.enable_gc à 1.

Question 10

bool gc_enabled ( void )

Answer 10

Retourne le statut du collecteur de références circulaires.

Question 11

string get_cfg_var ( string $option )

Answer 11

Retourne la valeur de l’option option de configuration PHP.

get_cfg_var() ne retourne pas les options qui ont été choisies lors de la compilation de PHP, ni ne lit dans le fichier de configuration d’Apache.

Pour vérifier si le système utilise le fichier de configuration, essayez de lire la valeur de cfg_file_path. Si cette valeur est disponible, alors le fichier de configuration est utilisé.

Question 12

string get_current_user ( void )

Answer 12

Retourne le nom du possesseur du script courant.

Question 13

array get_defined_constants ([ bool $categorize = false ] )

Answer 13

Retourne les noms et valeurs des constantes déjà définies. Cela inclut les constantes créées par les extensions, et celles créées avec la fonction define().

Question 14

array get_extension_funcs ( string $module_name )

Answer 14

Retourne le nom des fonctions définies dans le module module_name.

Question 15

string get_include_path ( void )

Answer 15

Lit la valeur de la directive de configuration include_path.

Question 16

array get_included_files ( void )

Answer 16

Retourne un tableau contenant les noms de tous les fichiers qui ont été ajoutés au script avec les fonctions include, include_once, require ou require_once.

Question 17

array get_loaded_extensions ([ bool $zend_extensions = false ] )

Answer 17

Retourne un tableau contenant les noms de tous les modules compilés et chargés par l’application PHP courante.

Question 18

bool get_magic_quotes_gpc ( void )

Answer 18

Retourne la configuration actuelle de l’option magic_quotes_gpc

Gardez en tête que vous ne pouvez pas définir magic_quotes_gpc au moment de l’exécution.

Pour plus d’informations sur magic_quotes, voir la section sur les guillemets magiques.

Question 19

bool get_magic_quotes_runtime ( void )

Answer 19

Retourne la configuration actuelle de l’option magic_quotes_runtime.

Question 20

get_required_files()

Answer 20

Cette fonction est un alias de : get_included_files().

Question 21

string getenv ( string $varname )

Answer 21

Retourne la valeur d’une variable d’environnement.

Vous pouvez voir une liste complète des variables d’environnement en utilisant la fonction phpinfo(). Vous pouvez trouver la signification de chacune d’entre elles en consultant la » RFC 3875, en particulier la section 4.1 “Request Meta-Variables”.

Question 22

int getlastmod ( void )

Answer 22

Retourne la date de dernière modification du script principal en exécution.

Si vous voulez récupérer la date de la dernière modification d’un fichier différent, utilisez la fonction filemtime().

Question 23

int getmygid ( void )

Answer 23

Retourne le GID du propriétaire du script.

Question 24

int getmyinode ( void )

Answer 24

Retourne l’inode du script courant.

Question 25

int getmypid ( void )

Answer 25

Retourne le numéro de processus courant de PHP.

Question 26

int getmyuid ( void )

Answer 26

Retourne l’UID du propriétaire du script actuel.

Question 27

array getopt ( string $options [, array $longopts ] )

Answer 27

getopt() lit les options passées dans la ligne de commande.

Question 28

array getrusage ([ int $who = 0 ] )

Answer 28

C’est une interface à la fonction système getrusage(2). Elle retourne un tableau associatif contenant les informations renvoyées par cet appel système.

Question 29

ini_alter()

Answer 29

Cette fonction est un alias de : ini_set().

Question 30

array ini_get_all ([ string $extension [, bool $details = true ]] )

Answer 30

Lit toutes les valeurs de configuration.

Question 31

string ini_get ( string $varname )

Answer 31

Retourne la valeur de l’option de configuration varname en cas de succès.

Question 32

void ini_restore ( string $varname )

Answer 32

Restaure la valeur originale de l’option de configuration varname.

Question 33

string ini_set ( string $varname , string $newvalue )

Answer 33

Change la valeur de l’option de configuration varname et lui donne celle de newvalue. La valeur de l’option de configuration sera modifiée durant toute l’exécution du script et pour ce script spécifiquement. Elle reprendra sa valeur par défaut dès la fin du script.

Question 34

magic_quotes_runtime()

Answer 34

Cette fonction est un alias de : set_magic_quotes_runtime()

Question 35

int memory_get_peak_usage ([ bool $real_usage = false ] )

Answer 35

Retourne la quantité de mémoire maximale, en octets, qui a été allouée à votre script PHP.

Question 36

int memory_get_usage ([ bool $real_usage = false ] )

Answer 36

Retourne la quantité de mémoire allouée à PHP à cet instant.

Question 37

string php_ini_loaded_file ( void )

Answer 37

Vérifie si un fichier php.ini est chargé, et récupère son chemin.

Question 38

string php_ini_scanned_files ( void )

Answer 38

php_ini_scanned_files() retourne une liste de noms de fichiers de configuration analysés, en plus de php.ini. Cette liste est au format CSV. Ces fichiers sont situés dans un dossier défini par l’option –with-config-file-scan-dir , définie au moment de la compilation.

Les fichiers retournés incluent le chemin, comme déclaré dans la directive –with-config-file-scan-dir . De plus, chaque virgule est suivie d’une nouvelle ligne.

Question 39

string php_logo_guid ( void )

Answer 39

Cette fonction retourne l’identifiant qui peut être utilisé pour afficher le logo PHP en utilisant une image incorporée dans les sources. Le logo est affiché uniquement si expose_php vaut On.
Avertissement

Cette fonction est obsolète et a été supprimée depuis PHP 5.5.0.

Question 40

string php_sapi_name ( void )

Answer 40

Retourne une chaîne en minuscule qui décrit le type d’interface (l’API, SAPI serveur) que PHP utilise. Par exemple, en PHP CLI, cette chaîne sera “cli” tandis qu’avec Apache, elle pourra avoir plusieurs valeurs différentes suivant le SAPI exact utilisé. Les valeurs possibles sont listées ci-dessous.

Question 41

string php_uname ([ string $mode = “a” ] )

Answer 41

php_uname() retourne une description sur le système d’exploitation sur lequel tourne PHP. C’est la même chaîne que celle que vous voyez en haut du phpinfo(). Si vous voulez juste savoir le nom du système d’exploitation, utilisez plutôt la constante PHP_OS mais gardez à l’esprit que cette constante contient le nom du système sur lequel PHP a été compilé.

Sur certaines vieilles plate-formes Unix, il n’est pas possible de déterminer les informations courantes de l’OS, auquel cas cette fonction se contente de retourner le nom de l’OS sur lequel PHP a été compilé. Cela n’arrivera que si votre bibliothèque uname() n’existe pas ou ne fonctionne pas.

Question 42

bool phpcredits ([ int $flag = CREDITS_ALL ] )

Answer 42

Affiche la liste des développeurs PHP, des modules, etc. Elle génère le code HTML approprié pour insérer les informations dans une page.

Question 43

bool phpinfo ([ int $what = INFO_ALL ] )

Answer 43

Affiche de nombreuses informations sur PHP, concernant sa configuration courante : options de compilation, extensions, version, informations sur le serveur, et l’environnement (lorsqu’il est compilé comme module), environnement PHP, informations sur le système, chemins, valeurs générales et locales de configuration, en-têtes HTTP et la licence PHP.

Comme tous les systèmes sont configurés différemment, phpinfo() sert généralement à vérifier la configuration ainsi que les variables prédéfinies, pour une plate-forme donnée.

phpinfo() est un bon outil de débogage, car il affiche le contenu de toutes les variables EGPCS (Environnement, GET, POST, Cookie, Serveur).

Question 44

string phpversion ([ string $extension ] )

Answer 44

Retourne le numéro de la version courante de PHP.

Question 45

bool putenv ( string $setting )

Answer 45

Fixe la valeur d’une variable d’environnement. Cette valeur n’existera que durant la vie du script courant, et l’environnement initial sera restauré lorsque le script sera terminé.

Modifier la valeur de certaines variables système peut être un trou de sécurité considérable. La directive de configuration safe_mode_allowed_env_vars contient une liste de préfixes, séparés par des virgules. Lorsque le Safe Mode est actif, l’utilisateur ne peut que modifier les variables dont le nom commence par les préfixes fournis par cette directive. Par défaut, les utilisateurs ne peuvent modifier que les variables qui commencent par PHP_ (i.e. PHP_FOO=BAR). Note : Si cette directive est vide, PHP autorisera la modification de TOUTES les variables d’environnement !

La directive de configuration safe_mode_protected_env_vars contient une liste de variables d’environnement, séparées par des virgules. Les utilisateurs ne pourront pas modifier ces variables avec la fonction putenv(). Ces variables seront protégées même si safe_mode_allowed_env_vars permet leur modification.

Question 46

void restore_include_path ( void )

Answer 46

Restaure la valeur de la directive de configuration include_path à sa valeur originale de début de script, telle qu’inscrite dans le php.ini.

Question 47

string set_include_path ( string $new_include_path )

Answer 47

Modifie la valeur de la directive de configuration include_path, pour la durée du script en cours.

Question 48

bool set_magic_quotes_runtime ( bool $new_setting )

Answer 48

Active/désactive l’option magic_quotes_runtime.
Avertissement

Cette fonction est OBSOLETE depuis PHP 5.3.0. Nous vous encourageons vivement à ne plus l’utiliser.

Question 49

bool set_time_limit ( int $seconds )

Answer 49

Fixe le délai d’expiration d’un script, en secondes. Si cette limite est atteinte, le script s’interrompt, et renvoie une erreur fatale. La valeur par défaut est 30 secondes ou, si c’est le cas, la valeur de la directive max_execution_time définie dans le php.ini.

Lorsqu’elle est appelée, set_time_limit() remet le compteur à zéro. En d’autres termes, si la limite par défaut est à 30 secondes, et qu’après 25 secondes d’exécution du script l’appel set_time_limit(20) est fait, alors le script tournera pendant un total de 45 secondes avant de finir.

Question 50

string sys_get_temp_dir ( void )

Answer 50

Retourne le chemin du répertoire PHP où sont enregistrés les fichiers temporaires par défaut.

Question 51

mixed version_compare ( string $version1 , string $version2 [, string $operator ] )

Answer 51

version_compare() compare les deux versions de PHP standardisées.

version_compare() remplace dans un premier temps _, - et + par un point (.) dans les chaînes de version et insère aussi des points avant et après tout caractère non-numérique pour que, par exemple, ‘4.3.5RC1’ devienne ‘4.3.5.RC.1’. Puis, elle compare les morceaux en allant de gauche à droite. Si une part contient des caractères alphabétiques, ils sont gérés dans l’ordre suivant : any string not found in this list < dev < alpha = a < beta = b < RC = rc < # < pl = p. De cette façon, il est possible de comparer non seulement des versions de différents niveaux, comme ‘4.1’ et ‘4.1.2’, mais aussi des versions de développement à la mode de PHP, à n’importe quel stade.

Question 52

string zend_logo_guid ( void )

Answer 52

zend_logo_guid() retourne l’identifiant pouvant être utilisé pour afficher le logo Zend en utilisant l’image intégrée.
Avertissement

Cette fonction est obsolète et a été supprimée depuis PHP 5.5.0.

Question 53

int zend_thread_id ( void )

Answer 53

Cette fonction retourne un identifiant unique pour le thread courant.

Question 54

string zend_version ( void )

Answer 54

Retourne une chaîne contenant le numéro de version du moteur d’analyse Zend actuellement en cours d’utilisation.