Manuel PHP
Précédent |  | Suivant

# CXI. Analyseur de code PHP

# Introduction

Les fonctions du tokenizer fournissent une interface avec l'analyseur interne de PHP, intégré dans le moteur Zend. En utilisant ces fonctions, vous pouvez écrire votre propre système d'analyse des sources PHP, ou bien des outils de modification du code, sans avoir à refaire toute l'analyse lexicale.

Voir aussi l'annexe sur les tokens.

# Pré-requis

Ces fonctions sont disponibles dans le module PHP standard, qui est toujours accessible.

# Installation

A partir de PHP 4.3.0, ces fonctions sont activées par défaut. Pour les anciennes versions, vous devez compiler `PHP` avec l'option `--enable-tokenizer`. Vous pouvez désactiver le support de l'extension tokenizer avec l'option `--disable-tokenizer`.

La version Windows de `PHP` dispose du support automatique de cette extension. Vous n'avez pas à ajouter de librairie supplémentaire pour disposer de ces fonctions.

> Note : Le support automatique du tokenizer est disponible depuis PHP 4.3.0.

# Constantes prédefinies

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.

`T_INCLUDE` (integer)

`T_INCLUDE_ONCE` (integer)

`T_EVAL` (integer)

`T_REQUIRE` (integer)

`T_REQUIRE_ONCE` (integer)

`T_LOGICAL_OR` (integer)

`T_LOGICAL_XOR` (integer)

`T_LOGICAL_AND` (integer)

`T_PRINT` (integer)

`T_PLUS_EQUAL` (integer)

`T_MINUS_EQUAL` (integer)

`T_MUL_EQUAL` (integer)

`T_DIV_EQUAL` (integer)

`T_CONCAT_EQUAL` (integer)

`T_MOD_EQUAL` (integer)

`T_AND_EQUAL` (integer)

`T_OR_EQUAL` (integer)

`T_XOR_EQUAL` (integer)

`T_SL_EQUAL` (integer)

`T_SR_EQUAL` (integer)

`T_BOOLEAN_OR` (integer)

`T_BOOLEAN_AND` (integer)

`T_IS_EQUAL` (integer)

`T_IS_NOT_EQUAL` (integer)

`T_IS_IDENTICAL` (integer)

`T_IS_NOT_IDENTICAL` (integer)

`T_IS_SMALLER_OR_EQUAL` (integer)

`T_IS_GREATER_OR_EQUAL` (integer)

`T_SL` (integer)

`T_SR` (integer)

`T_INC` (integer)

`T_DEC` (integer)

`T_INT_CAST` (integer)

`T_DOUBLE_CAST` (integer)

`T_STRING_CAST` (integer)

`T_ARRAY_CAST` (integer)

`T_OBJECT_CAST` (integer)

`T_BOOL_CAST` (integer)

`T_UNSET_CAST` (integer)

`T_NEW` (integer)

`T_EXIT` (integer)

`T_IF` (integer)

`T_ELSEIF` (integer)

`T_ELSE` (integer)

`T_ENDIF` (integer)

`T_LNUMBER` (integer)

`T_DNUMBER` (integer)

`T_STRING` (integer)

`T_STRING_VARNAME` (integer)

`T_VARIABLE` (integer)

`T_NUM_STRING` (integer)

`T_INLINE_HTML` (integer)

`T_CHARACTER` (integer)

`T_BAD_CHARACTER` (integer)

`T_ENCAPSED_AND_WHITESPACE` (integer)

`T_CONSTANT_ENCAPSED_STRING` (integer)

`T_ECHO` (integer)

`T_DO` (integer)

`T_WHILE` (integer)

`T_ENDWHILE` (integer)

`T_FOR` (integer)

`T_ENDFOR` (integer)

`T_FOREACH` (integer)

`T_ENDFOREACH` (integer)

`T_DECLARE` (integer)

`T_ENDDECLARE` (integer)

`T_AS` (integer)

`T_SWITCH` (integer)

`T_ENDSWITCH` (integer)

`T_CASE` (integer)

`T_DEFAULT` (integer)

`T_BREAK` (integer)

`T_CONTINUE` (integer)

`T_OLD_FUNCTION` (integer)

`T_FUNCTION` (integer)

`T_CONST` (integer)

`T_RETURN` (integer)

`T_USE` (integer)

`T_GLOBAL` (integer)

`T_STATIC` (integer)

`T_VAR` (integer)

`T_UNSET` (integer)

`T_ISSET` (integer)

`T_EMPTY` (integer)

`T_CLASS` (integer)

`T_EXTENDS` (integer)

`T_OBJECT_OPERATOR` (integer)

`T_DOUBLE_ARROW` (integer)

`T_LIST` (integer)

`T_ARRAY` (integer)

`T_LINE` (integer)

`T_FILE` (integer)

`T_COMMENT` (integer)

`T_ML_COMMENT` (integer)

  > Note : `T_ML_COMMENT` n'est pas définie dans PHP 5. Touts les commentaires en PHP 5 sont des `T_COMMENT`.

`T_DOC_COMMENT` (integer)

  > Note : `T_DOC_COMMENT` a été ajouté en PHP 5.

`T_OPEN_TAG` (integer)

`T_OPEN_TAG_WITH_ECHO` (integer)

`T_CLOSE_TAG` (integer)

`T_WHITESPACE` (integer)

`T_START_HEREDOC` (integer)

`T_END_HEREDOC` (integer)

`T_DOLLAR_OPEN_CURLY_BRACES` (integer)

`T_CURLY_OPEN` (integer)

`T_PAAMAYIM_NEKUDOTAYIM` (integer)

`T_DOUBLE_COLON` (integer)

# Exemples

Voici un exemple simple de script PHP qui utilise le tokenizer pour lire un fichier, supprimer tous les commentaires de la source, et afficher uniquement du code.

Exemple 1. Suppression de commentaires avec le tokenizer

`<?php
$source = file_get_contents("somefile.php");
$tokens = token_get_all($source);
/* T_ML_COMMENT does not exist in PHP 5.
* The following three lines define it in order to
* preserve backwards compatibility.
*
* The next two lines define the PHP 5-only T_DOC_COMMENT,
* which we will mask as T_ML_COMMENT for PHP 4.
*/
if (!defined('T_ML_COMMENT')) {
define('T_ML_COMMENT', T_COMMENT);
} else {
define('T_DOC_COMMENT', T_ML_COMMENT);
}
foreach ($tokens as $token) {
if (is_string($token)) {
// simple 1-character token
echo $token;
} else {
// token array
list($id, $text) = $token;
switch ($id) {
case T_COMMENT:
case T_ML_COMMENT: // we've defined this
case T_DOC_COMMENT: // and this
// no action on comments
break;
default:
// anything else -> output "as is"
echo $text;
break;
}
}
}
?>`

Précédent | Sommaire | Suivant
tidy_warning_count | Niveau supérieur | token_get_all