This library parses PHP code into logical components for inspection and automation.

Some features:

Detect classes from files, folders, or raw strings.
Parse PHP tokens using `token_get_all`.
Extract class metadata (name, namespace, path).
Retrieve class properties, methods, and functions.
Extract function/method code or raw bodies.
Read namespaces, use statements, and includes.
Extract and remove comments or PHPDoc blocks.

Usage

Init:

include dirname(__DIR__) . "/lib/app.php";
include get_lib("phpscript.PHPCodePrintingHandler");

$folder_path = "/tmp/php";
$file_path = "$folder_path/test.php";
$code = file_get_contents($file_path); //some php code, encapsulated with php tags

Get Classes:

$classes_by_file_path = PHPCodePrintingHandler::getPHPClassesFromFolder($folder_path); //Get classes from folder - only 1 level
$classes_by_file_path = PHPCodePrintingHandler::getPHPClassesFromFolderRecursively($folder_path); //Get classes from folder and sub-folders - all levels
$classes = PHPCodePrintingHandler::getPHPClassesFromFile($file_path); //Get classes from file
$classes = PHPCodePrintingHandler::getPHPClassesFromString($code); //Get classes from code

$tokens = token_get_all($code);
$classes = PHPCodePrintingHandler::getPHPClassesFromTokens($tokens); //Get classes from tokens

Get Class Components:

if (key($classes) == 0)
	next($classes);

$class_path = key($classes);
$class_name = $classes[$class_path]["name"];

$array = PHPCodePrintingHandler::decoupleClassNameWithNameSpace($class_path); //Return array("class_name" => $class_path, "namespace" => $namespace, "name" => $class_name)

$class_path = PHPCodePrintingHandler::prepareClassNameWithNameSpace($class_name, $namespace = ""); //Return string class name together with namespace
$class_path = PHPCodePrintingHandler::getClassPathFromClassName($file_path, $class_name); //The $class_name may be without namespace.

$class_components = PHPCodePrintingHandler::getClassOfFile($file_path); //get class components with the same name than the file name
$class_components = PHPCodePrintingHandler::getClassFromFile($file_path, $class_path); //Get class components from file.
$class_components = PHPCodePrintingHandler::getClassFromPHPClasses($classes, $class_path); //Get class components from classes array.
$class_components = PHPCodePrintingHandler::searchClassFromPHPClasses($classes, $class_path); //Search class in classes and return its components.

Get Class Properties:

$property_components = PHPCodePrintingHandler::getClassPropertyFromFile($file_path, $class_path, $prop_name);
$properties_components = PHPCodePrintingHandler::getClassPropertiesFromFile($file_path, $class_path);
$properties_components = PHPCodePrintingHandler::getClassPropertiesFromString($contents, $class_path);

Get Function/Method Components:

//If is a class method, instead of a function, then set the correspondent $class_path var.
$function_components = PHPCodePrintingHandler::getFunctionFromFile($file_path, $func_name, $class_path = 0);
$function_components = PHPCodePrintingHandler::getFunctionFromString($code, $func_name, $class_path = 0);
$function_components = PHPCodePrintingHandler::getFunctionCodeFromFile($file_path, $func_name, $class_path = 0, $raw = false);
$function_components = PHPCodePrintingHandler::getFunctionCodeFromString($code, $func_name, $class_path = 0, $raw = false);

Get Namespaces/Uses/Includes:

//Namespaces
$namespaces = PHPCodePrintingHandler::getNamespacesFromFile($file_path); //Return array with namespaces names

//Uses
$uses = PHPCodePrintingHandler::getUsesFromFile($file_path); //Return associative array key-value pair, where keys are use-name and values are use-alias

//Includes
$includes_components = PHPCodePrintingHandler::getIncludesFromFile($file_path); //Return array with other arrays like: array($code_or_path, $is_once)

Get Comments:

$comments = $class_components["comments"];
$doc_comments = $class_components["doc_comments"];

$code = PHPCodePrintingHandler::getCodeWithoutCommentsFromFile($file_path);
$code = PHPCodePrintingHandler::getCodeWithoutComments($code);

PHP Code Parser Lib