L'elenco completo delle opzioni del PHP disponibili da linea di comando può essere visualizzato in qualsiasi momento eseguendo il PHP con l'opzione -h :
Usage: php [options] [-f] <file> [--] [args...] php [options] -r <code> [--] [args...] php [options] [-B <begin_code>] -R <code> [-E <end_code>] [--] [args...] php [options] [-B <begin_code>] -F <file> [-E <end_code>] [--] [args...] php [options] -- [args...] php [options] -a -a Run interactively -c <path>|<file> Look for php.ini file in this directory -n No php.ini file will be used -d foo[=bar] Define INI entry foo with value 'bar' -e Generate extended information for debugger/profiler -f <file> Parse and execute <file>. -h This help -i PHP information -l Syntax check only (lint) -m Show compiled in modules -r <code> Run PHP <code> without using script tags <?..?> -B <begin_code> Run PHP <begin_code> before processing input lines -R <code> Run PHP <code> for every input line -F <file> Parse and execute <file> for every input line -E <end_code> Run PHP <end_code> after processing all input lines -H Hide any passed arguments from external tools. -S <addr>:<port> Run with built-in web server. -t <docroot> Specify document root <docroot> for built-in web server. -s Output HTML syntax highlighted source. -v Version number -w Output source with stripped comments and whitespace. -z <file> Load Zend extension <file>. args... Arguments passed to script. Use -- args when first argument starts with - or script is read from stdin --ini Show configuration file names --rf <name> Show information about function <name>. --rc <name> Show information about class <name>. --re <name> Show information about extension <name>. --rz <name> Show information about Zend extension <name>. --ri <name> Show configuration for extension <name>.
Parametro | Parametro lungo | Descrizione |
---|---|---|
-a | --interactive |
Esegue il PHP in modo interattivo. Per maggiori informazioni, vedere la sezione Shell interattiva . |
-b | --bindpath |
Percorso per collegamento esterno alla modalità Server FASTCGI (solo CGI). |
-C | --no-chdir |
Non eseguire chdir nella cartella dello script (solo CGI). |
-q | --no-header |
Modo silenzioso. Sopprime l'emissione delle intestazioni HTTP (solo CGI). |
-T | --timing |
Misura il tempo di esecuzione dello script ripetutocount volte (solo CGI). |
-c | --php-ini |
Con questa opzione si può sia specificare la directory in cui cercare il php.ini o si può specificare un file INI personalizzato (che non deve necessariamente chiamarsi php.ini), ad esempio: $ php -c /custom/directory/ my_script.php $ php -c /custom/directory/custom-file.ini my_script.php Se non si specifica questa opzione, il file viene ricercato nelle directory di default. |
-n | --no-php-ini |
Ignora del tutto il php.ini. |
-d | --define |
Questa opzione permette di impostare valori personalizzati per qualsiasi delle direttive di configurazione previste in php.ini. La sintassi è: -d configuration_directive[=value] # Omettendo il valore si imposta la direttiva data a "1" $ php -d max_execution_time -r '$foo = ini_get("max_execution_time"); var_dump($foo);' string(1) "1" # Passando un valore vuoto si imposta la direttiva a "" php -d max_execution_time= -r '$foo = ini_get("max_execution_time"); var_dump($foo);' string(0) "" # La direttiva di configurazione viene impostata a qualsiasi valore passato dopo il carattere '=' $ php -d max_execution_time=20 -r '$foo = ini_get("max_execution_time"); var_dump($foo);' string(2) "20" $ php -d max_execution_time=doesntmakesense -r '$foo = ini_get("max_execution_time"); var_dump($foo);' string(15) "doesntmakesense" |
-e | --profile-info |
Genera informazioni estese per il debugger/profiler. |
-f | --file |
Analizza ed esegue il file passato con l'opzione -f . Questo parametro è opzionale e può essere omesso. Basta fornire il nome del file da eseguire.
|
-h e -? | --help e --usage | Con questa opzione si ha l'elenco dei comandi di linea ed una breve descrizione di questi. |
-i | --info | Questa opzione della linea di comando richiama la funzione phpinfo(), e ne visualizza il risultato. Se il PHP non funziona correttamente, è opportuno utilizzare php -i per verificare se sono visualizzati messaggi di errore prima o al posto della tabella con le informazioni. Fare attenzione quando si usa la modalità CGI, l'output è in formato HTML e quindi abbastanza abbondante. |
-l | --syntax-check |
Questa opzione fornisce un metodo pratico per eseguire un controllo sintattico di un dato codice PHP. Se il controllo ha successo, verrà visualizzato il testo No syntax errors detected in <filename> e alla shell sarà restituito il codice 0. Se si rilevano errori si avrà il testo Errors parsing <filename>, inoltre si avranno anche i messaggi di errore del parser ed alla shell sarà restituito il codice -1. Questa opzione non rileva errori fatali (tipo funzioni non definite). Occorre utilizzare l'opzione -f se si desidera rilevare gli errori fatali.
|
-m | --modules |
Example #1 Visualizzazione dei moduli PHP e di Zend integrati (e quindi caricati): $ php -m [PHP Modules] xml tokenizer standard session posix pcre overload mysql mbstring ctype [Zend Modules] |
-r | --run |
Questa opzione permette l'esecuzione di codice PHP direttamente da linea di comando. I tag PHP di apertura e di chiusura (<?php e ?>) non sono necessari anzi, se presenti, causano un errore del parser.
|
-B | --process-begin |
Codice PHP da eseguirsi prima di processare stdin. Aggiunto in PHP 5. |
-R | --process-code |
Esegue il codice PHP per ogni linea di input. Aggiunto in PHP 5. In questa modalità si hanno due variabili speciali: $argn ed $argi. $argn contiene la linea PHP in elaborazione al momento, mentre $argi contiene il numero di linea. |
-F | --process-file |
Esegue il file PHP per ogni linea di input. Aggiunto in PHP 5. |
-E | --process-end |
Codice PHP da eseguirsi dopo il processamento dell'input. Aggiunto in PHP 4. Example #4 Utilizzo delle opzioni -B , -R e -E per contare il numero di linea di un progetto. $ find my_proj | php -B '$l=0;' -R '$l += count(@file($argn));' -E 'echo "Total Lines: $l\n";' Total Lines: 37328 |
-S | --server |
Avvia il web server interno. Disponibile da PHP 5.4.0. |
-t | --docroot | Specifica la document root per il web server interno. Available as of PHP 5.4.0. |
-s | --syntax-highlight e --syntax-highlighting |
Visualizza il sorgente con sintassi colorata. Questa opzione utilizza il meccanismo interno di parsing dei file e produce una versione HTML evidenziata del sorgente dirigendola verso lo standard output. Occorre notare che questa funzione genera dei blocchi di tag HTML <code> [...] </code> e non le intestazioni HTML.
|
-v | --version |
Example #5 Utilizzo di -v per recuperare il nome SAPI e la versione di PHP e Zend $ php -v PHP 5.3.1 (cli) (built: Dec 11 2009 19:55:07) Copyright (c) 1997-2009 The PHP Group Zend Engine v2.3.0, Copyright (c) 1998-2009 Zend Technologies |
-w | --strip |
Visualizza il sorgente senza gli spazi e i commenti.
|
-z | --zend-extension |
Carica l'estensione Zend. Soltano se si fornisce un nome di file, il PHP tenta di caricare l'estensione dal corrente percorso di default delle librerie (solitamente, sui sistemi Linux, /etc/ld.so.conf). Se si fornisce un nome di file con percorso assoluto, ls libreria non sarà cercata nella directory di default. Un nome di file con percorso relativo indica al PHP di tentare di caricare l'estensione con percorso relativo alla directory corrente. |
--ini |
Visualizza i nomi dei file di configurazione e le cartelle esplorate. Disponibile da PHP 5.2.3. Example #6 Esempio di uso di --ini $ php --ini Configuration File (php.ini) Path: /usr/dev/php/5.2/lib Loaded Configuration File: /usr/dev/php/5.2/lib/php.ini Scan for additional .ini files in: (none) Additional .ini files parsed: (none) |
|
--rf | --rfunction |
Visualizza le informazioni della funzione o metodo di classe indicato (es. numero e nome dei parametri) Disponibile da PHP 5.1.2. Questa opzione è disponibile solo se PH è stato compilato con il supporto alla Reflection.
Example #7 semplice utilizzo di --rf $ php --rf var_dump Function [ <internal> public function var_dump ] { - Parameters [2] { Parameter #0 [ <required> $var ] Parameter #1 [ <optional> $... ] } } |
--rc | --rclass |
Visualizza le informazioni della classe indicata (lista delle costanti, proprietà e metodi). Disponibile da PHP 5.1.2. Questa opzione è disponibile solo se PH è stato compilato con il supporto alla Reflection.
Example #8 Esempio di --rc $ php --rc Directory Class [ <internal:standard> class Directory ] { - Constants [0] { } - Static properties [0] { } - Static methods [0] { } - Properties [0] { } - Methods [3] { Method [ <internal> public method close ] { } Method [ <internal> public method rewind ] { } Method [ <internal> public method read ] { } } } |
--re | --rextension |
Visualizza le informazioni dell'estensione indicata (elenco delle opzioni php.ini, funzioni, costanti and classi definite). Disponibile da PHP 5.1.2. Questa opzione è disponibile solo se PH è stato compilato con il supporto alla Reflection.
Example #9 Esempio di --re $ php --re json Extension [ <persistent> extension #19 json version 1.2.1 ] { - Functions { Function [ <internal> function json_encode ] { } Function [ <internal> function json_decode ] { } } } |
--rz | --rzendextension |
Visualizza le informazioni di configurazione per l'estensione Zend indicata (le stesse informazioni che sono fornite da phpinfo()). Disponibile da PHP 5.4.0. |
--ri | --rextinfo |
Visualizza le informazioni di configurazione per l'estensione indicata (le stesse informazioni che sono fornite da phpinfo()). Disponibile da PHP 5.2.2. Le informazioni di configurazione del sistema di base sono disponibili usando "main" come nome d'estensione.
Example #10 --ri example $ php --ri date date date/time support => enabled "Olson" Timezone Database Version => 2009.20 Timezone Database => internal Default timezone => Europe/Oslo Directive => Local Value => Master Value date.timezone => Europe/Oslo => Europe/Oslo date.default_latitude => 59.930972 => 59.930972 date.default_longitude => 10.776699 => 10.776699 date.sunset_zenith => 90.583333 => 90.583333 date.sunrise_zenith => 90.583333 => 90.583333 |
Nota:
Le options -rBRFEH, --ini e --r[fcezi] sono disponibili solo in modalità CLI.