Servidor web interno
Advertencia
Este servidor web ha sido diseñado para ayudar al desarrollo de aplicaciones.
También puede ser útil para propósitos de prueba o para demostraciones de
aplicaciones que se ejecutan en entornos controlados. No se pretende que sea
un servidor web con todas las funciones. No debe ser utilizado en una red
pública.
Desde PHP 5.4.0, la SAPI CLI provee un servidor web embebido.
El servidor web ejecuta solamente un único proceso monohilo, por lo que
las aplicaciones PHP se detendrán si la solicitud está bloqueada.
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, la búsqueda de index.php e index.html
continuará en el directorio padre y continuará así hasta encontrar uno de ello o
se alcance el directorio raíz. Si se encuentra index.php o index.html,
se devuelve este y $_SERVER['PATH_INFO'] se establece a la parte final del
URI. De lo contrario se devuelve un código de respuesta 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 para ficheros con extensiones: .3gp,
.apk, .avi, .bmp, .css, .csv, .doc, .docx, .flac, .gif, .gz,
.gzip, .htm, .html, .ics, .jpe, .jpeg, .jpg, .js, .kml, .kmz,
.m4a, .mov, .mp3, .mp4, .mpeg, .mpg, .odp, .ods, .odt, .oga, .ogg,
.ogv, .pdf, .pdf, .png, .pps, .pptx, .qt, .svg, .swf, .tar, .text,
.tif, .txt, .wav, .webm, .wmv, .xls, .xlsx, .xml, .xsl, .xsd, y .zip.
Registro de cambios: Tipos MIME soportados (extensiones de ficheros)
Versión |
Descripción |
5.5.12 |
.xml, .xsl, and .xsd
|
5.5.7 |
.3gp, .apk, .avi, .bmp, .csv, .doc, .docx, .flac, .gz, .gzip,
.ics, .kml, .kmz, .m4a, .mp3, .mp4, .mpg, .mpeg, .mov, .odp, .ods,
.odt, .oga, .pdf, .pptx, .pps, .qt, .swf, .tar, .text, .tif, .wav,
.wmv, .xls, .xlsx, y .zip
|
5.5.5 |
.pdf
|
5.4.11 |
.ogg, .ogv, and .webm
|
5.4.4 |
.htm and .svg
|
Ejemplo #1 Iniciando el servidor web
$ cd ~/public_html
$ php -S localhost:8000
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/
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"] == "el") {
header("Content-Type: text/x-script.elisp");
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: