Consola interactiva
There no problem to configure xdebug with php 5.4 built-in server.
If you debugging on local (dev) machine you need to :
1) add to php.ini:
zend_extention=/abosute/path/to/xdebug.dll
# USE ABSOLUTE PATH!!! relative path does not work.
#http://xdebug.org/docs/install
xdebug.remote_enable=1
2) run php from command line:
php.exe -S localhost:3000
3) check if xdebug loaded:
#index.php
<?php phpinfo(); ?>
4) configure NetBeans, Eclipse to work with localhost:3000
Notes: latest release of NetBeans 7.1,(7.2RC) (date july 2012)
seems to be unstable when working with build-in webserver and xdebug, but Eclipse PDT works fine.
Servidor web embebido
Desde PHP 5.4.0, la CLI SAPI provee un servidor web embebido.
Este servidor web está diseñado solamente para propósitos de desarrollo, y no debería ser utilizado en ambientes en producción.
Las peticiones se sirven secuencialmente.
Las peticiones de URI se sirven desde el actual directorio de trabajo donde PHP se inició, a menos que la opción -t sea utilizada para especificar una raíz de documentos explícita. Si una petición de URI no especifica un fichero, entonces el index.php o index.html que estén en el directorio dado serán devueltos. Si ninguno de los ficheros existen en el directorio, entonces será devuelto una respuesta de código 404.
Si un fichero PHP es proporcionado en la línea de comandos cuando se inicia el
servidor web éste es tratado como un script "enrutador". El script es ejecutado
al inicio de cada petición HTTP. Si este script devuelve FALSE, entonces el
recurso solicitado se devuelve tal cual está. De otra forma la salida del script
se devuelve en el navegador.
Los tipos MIME estándar son devueltos por ficheros con extensiones: .css, .gif, .htm, .html, .jpe, .jpeg, .jpg, .js, .png, .svg, y .txt. Las extensiones .htm y .svg son reconocidas desde PHP 5.4.4 en adelante.
Ejemplo #1 Iniciando el servidor web
$ cd ~/public_html $ php -S localhost:8000
La terminal mostrará:
PHP 5.4.0 Servidor de desarrollo iniciado en Jueves Julio 21 10:43:28 2011 Escuchando en localhost:8000 La raíz de documentos es /home/usuario/html_público Presione Ctrl-C para salir
Después de una petición de una URI para http://localhost:8000/ y http://localhost:8000/mi_script.html la terminal mostrará algo similar a:
PHP 5.4.0 Servidor de desarrollo iniciado en Jueves Julio 21 10:43:28 2011 Escuchando en localhost:8000 La raíz de documentos es /home/usuario/html_público Presione Ctrl-C para salir. [Thu Jul 21 10:48:48 2011] ::1:39144 GET /favicon.ico - Petición leída [Thu Jul 21 10:48:50 2011] ::1:39146 GET / - Petición leída [Thu Jul 21 10:48:50 2011] ::1:39147 GET /favicon.ico - Petición leída [Thu Jul 21 10:48:52 2011] ::1:39148 GET /mi_script.html - Petición leída [Thu Jul 21 10:48:52 2011] ::1:39149 GET /favicon.ico - Petición leída
Ejemplo #2 Iniciando con una raíz de documentos específica
$ cd ~/html_público $ php -S localhost:8000 -t foo/
La terminal mostrará:
PHP 5.4.0 Servidor de desarrollo iniciado en Jueves Julio 21 10:50:26 2011 Escuchando en localhost:8000 La raíz de documentos es /home/usuario/html_público/foo Presione Ctrl-C para salir
Ejemplo #3 Utilizando un Script enrutador
En este ejemplo, las peticiones a las imágenes se mostrarán, pero las peticiones a ficheros HTML mostrarán "Bienvenido a PHP":
<?php
// router.php
if (preg_match('/\.(?:png|jpg|jpeg|gif)$/', $_SERVER["REQUEST_URI"])){
return false; // servir la petición tal cual es.
}else {
echo "<p>Bienvenido a PHP</p>";
}
?>
$ php -S localhost:8000 router.php
Ejemplo #4 Revisión del uso de la CLI del servidor web
Para reutilizar un framework de script enrutador durante el desarrollo con la CLI del servidor web server y luego con un servidor web en producción:
<?php
// router.php
if (php_sapi_name() == 'cli-server') {
/* los activos de ruta estática y devolver falso */
}
/* seguir adelante con operaciones normales de index.php */
?>
$ php -S localhost:8000 router.php
Ejemplo #5 Manejando tipos de ficheros no soportados
Si necesita servir un recurso estático cuyo tipo MIME no es manejado por la CLI del servidor web, utilice:
<?php
// router.php
$path = pathinfo($_SERVER["SCRIPT_FILENAME"]);
if ($path["extension"] == "ogg") {
header("Content-Type: video/ogg");
readfile($_SERVER["SCRIPT_FILENAME"]);
}
else {
return FALSE;
}
?>
$ php -S localhost:8000 router.php
Ejemplo #6 Accediendo a la CLI del servidor web desde máquinas remotas
Puede hacer que el servidor web sea accesible en el puerto 8000 a cualquier interfaz con:
$ php -S 0.0.0.0:8000
add a note
User Contributed Notes
Servidor web embebido - [6 notes]
zealotous at gmail dot com ¶
10 months ago
Miguel Juan Semanino ¶
11 months ago
Note: as of PHP 5.4.3 on Windows, $_ENV is an empty array for all incoming requests.
matthewkastor at gmail dot com ¶
8 months ago
The commandline webserver kept giving me 404's when I would request a directory. It would only automatically find index.php. Since I wanted links to subdirectories and index.html to be processed automatically, I made a router that does it. I left three handlers dangling out there to make it easy to process files, directories, or 404's. I was thinking this might be useful and that someone else might not like the way my auto index looks, so I tried to make this code easy to alter.
<?php
function atropa_router() {
function add_single_trailing_fslash($to) {
if(!$to) return '/';
if(substr($to, -1) !== '/') {
$to = $to . '/';
}
return $to;
}
function get_absolute_path_to_request() {
$p = parse_url($_SERVER["REQUEST_URI"], PHP_URL_PATH);
if( is_null($p) ) {
$req = $_SERVER['DOCUMENT_ROOT'];
} else {
$req = $_SERVER['DOCUMENT_ROOT'] . $p;
}
return $req;
}
function path_has_filename($req) {
$req = pathinfo($req, PATHINFO_BASENAME);
if($req) {
return true;
} else {
return false;
}
}
function web_index_exists($dir) {
if(is_file($dir . "/index.php") ) {
return true;
} else {
return false;
}
}
function process_request() {
$req = get_absolute_path_to_request();
if(path_has_filename($req)) {
if (is_file($req)) {
if(!file_handler($req)) {
return false; // serve the requested resource as-is.
}
}
}
if(is_dir($req)) {
if (web_index_exists($req)) {
return false;
} elseif ( is_file($req . "/index.html")) {
$loc = add_single_trailing_fslash($_SERVER['REQUEST_URI']);
header('Location: ' . $loc . 'index.html');
exit;
} else {
directory_handler($req);
}
} else {
not_found_handler($req);
}
}
if(process_request() === false) {
return false;
}
}
function file_handler($req) {
return false;
}
function directory_handler($req) {
$d = dir($req);
$p = parse_url($_SERVER["REQUEST_URI"], PHP_URL_PATH);
$separator = '/';
$p = add_single_trailing_fslash($p);
echo '<!Doctype html><html><head><title>Directory</title></head><body>';
echo "Location: " . $d->path . '<br>';
echo '<table><tr><th>Name</th><th>Type</th></tr>';
while (false !== ($entry = $d->read())) {
if($entry === '.') continue;
if(is_file($req . '/' . $entry)) {
$separator = '';
$type = 'File';
} else {
$separator = '/';
$type = 'Directory';
}
echo '<tr><td><a href="' . $p . $entry . $separator . '">' . $entry . '</a></td><td>' . $type . '</td></tr>';
}
$d->close();
echo '</table></body></html>';
}
function not_found_handler($req) {
header('HTTP/1.1 404 Not Found');
echo '<!Doctype html><html><head><title>404</title></head><body><p>Requested resource could not be found</p></body></html>';
}
return atropa_router();
?>
Stefano F. Rausch ¶
1 year ago
To develop / deploy websites in 3 stages, i.e. ( 1 ) locally, ( 2 ) with an access controlled dedicated beta / test website in the www and ( 3 ) the production site, you can have ( 1 ) & ( 2 ) using the same domain name - port free - as follows:
- look up the IP address of the beta.web.site
and edit the hosts file to reflect:
- <IP> beta.web.site
- 127.0.0.1 beta.web.site
Start the built-in web server to work locally with:
- sudo php -S beta.web.site:80
and just hit http://beta.web.site as usual. Switching back and forth between ( 1 ) and ( 2 ) is as easy as telling the php engine not to fake a server any more :) Nice!
Happy PHP'ing.
matthewkastor at gmail dot com ¶
8 months ago
Updated Autoindex router for PHP built in server
<?php
/**
* Rev. 2 Autoindex Router for PHP built in webserver
* Fixes error where given http://localhost/? and localhost
* only contains index.html, the router redirects endlessly.
*/
function atropa_router() {
function add_single_trailing_fslash($to) {
if(!$to) return '/';
if(substr($to, -1) !== '/') {
$to = $to . '/';
}
return $to;
}
function get_request_uri_path() {
$p = parse_url($_SERVER["REQUEST_URI"], PHP_URL_PATH);
if( is_null($p) ) {
$req = '/';
} else {
$req = $p;
}
return $req;
}
function get_absolute_path_to_request() {
return $_SERVER['DOCUMENT_ROOT'] . get_request_uri_path();
}
function path_has_filename($req) {
$req = pathinfo($req, PATHINFO_BASENAME);
if($req) {
return true;
} else {
return false;
}
}
function web_index_exists($dir) {
if(is_file($dir . "index.php") ) {
return true;
} else {
return false;
}
}
function process_request() {
$req = get_absolute_path_to_request();
if(path_has_filename($req)) {
if (is_file($req)) {
if(!file_handler($req)) {
return false; // serve the requested resource as-is.
}
}
}
if(is_dir($req)) {
$req = add_single_trailing_fslash($req);
if (web_index_exists($req)) {
return false;
} elseif ( is_file($req . "index.html")) {
$loc = get_request_uri_path();
$loc = add_single_trailing_fslash($loc);
header('Location: ' . $loc . 'index.html');
exit;
} else {
directory_handler($req);
}
} else {
not_found_handler($req);
}
}
if(process_request() === false) {
return false;
}
}
function file_handler($req) {
return false;
}
function directory_handler($req) {
$d = dir($req);
$p = get_request_uri_path();
$p = add_single_trailing_fslash($p);
echo '<!Doctype html><html><head><title>Directory</title></head><body>';
echo "Location: $d->path <br>";
echo '<table><tr><th>Name</th><th>Type</th></tr>';
while (false !== ($entry = $d->read())) {
if($entry === '.') continue;
$href = $p . $entry;
if(is_file($req . $entry)) {
$type = 'File';
} else {
$href = add_single_trailing_fslash($href);
$type = 'Directory';
}
echo "<tr><td><a href='$href'>$entry</a></td><td>$type</td></tr>";
}
$d->close();
echo '</table></body></html>';
}
function not_found_handler($req) {
header('HTTP/1.1 404 Not Found');
echo '<!Doctype html><html><head><title>404</title></head><body><p>Requested resource could not be found</p></body></html>';
}
return atropa_router();
?>
dstrout at dstrout dot net ¶
1 month ago
Just gave it a try, and it is IPv6 compatible, if anyone was wondering.