El primer argumento de cualquier método que ejecuta una acción es el objeto que representa a la petición, llamada sfWebRequest
en Symfony. De todos sus métodos, ya se ha mostrado el método getParameter('miparametro')
para obtener el valor de un parámetro de la petición a partir de su nombre. La tabla 6-1 resume algunos de los métodos más útiles de sfWebRequest
.
Tabla 6-1. Métodos del objeto sfWebRequest
Nombre | Función | Ejemplo de salida producida |
---|---|---|
Información sobre la petición | ||
isMethod($metodo) |
Permite descubrir si el método empleado es POST o GET |
Devuelve true o false |
getMethod() |
Método de la petición | Devuelve la constante sfRequest::GET o sfRequest::POST |
getMethodName() |
Nombre del método de petición | POST |
getHttpHeader('Server') |
Valor de una cabecera HTTP | Apache/2.0.59 (Unix) DAV/2 PHP/5.1.6 |
getCookie('foo') |
Valor de una cookie | valor |
isXmlHttpRequest() (1) |
¿Es una petición AJAX? | true |
isSecure() |
¿Es una petición SSL? | true |
Parámetros de la petición | ||
hasParameter('parametro') |
¿Existe el parámetro en la petición? | true |
getParameter('parametro') |
Valor del parámetro | valor |
getParameterHolder()->getAll() |
Array de todos los parámetros de la petición | |
Información relacionada con la URI | ||
getUri() |
URI completa | http://localhost/frontend_dev.php/mimodulo/miaccion |
getPathInfo() |
Información de la ruta | /mimodulo/miaccion |
getReferer() (2) |
Valor del "referer" de la petición | http://localhost/frontend_dev.php/ |
getHost() |
Nombre del Host | localhost |
getScriptName() |
Nombre y ruta del controlador frontal | frontend_dev.php |
Información del navegador del cliente | ||
getLanguages() |
Array de los lenguajes aceptados | Array( [0] => fr [1] => fr_FR [2] => en_US [3] => en ) |
getCharsets() |
Array de los juegos de caracteres aceptados | Array( [0] => ISO-8859-1 [1] => UTF-8 [2] => * ) |
getAcceptableContentType() |
Array de los tipos de contenidos aceptados | Array( [0] => text/xml [1] => text/html |
(1) Funciona con Prototype, Mootools y jQuery (2) Si se utilizan proxys, su valor puede ser inaccesible
Para peticiones de tipo multipart utilizadas cuando el usuario adjunta archivos, el objeto sfWebRequest
provee métodos para acceder y mover estos archivos, como se muestra en el listado 6-14. Sin embargo, estos métodos han sido declarados como obsoletos en Symfony 1.1 (puedes ver más información en la sección de formularios y en la clase sfValidatorFile
).
Listado 6-14 - El objeto sfWebRequest
sabe cómo manejar archivos adjuntos
class mimoduloActions extends sfActions
{
public function executeSubirArchivos($peticion)
{
if ($peticion->hasFiles())
{
foreach ($peticion->getFileNames() as $archivoSubido)
{
$nombreArchivo = $peticion->getFileName($archivoSubido);
$tamanoArchivo = $peticion->getFileSize($archivoSubido);
$tipoArchivo = $peticion->getFileType($archivoSubido);
$archivoErroneo = $peticion->hasFileError($archivoSubido);
$directorioSubidas = sfConfig::get('sf_upload_dir');
$peticion->moveFile($archivoSubido, $directorioSubidas.'/'.$nombreArchivo);
}
}
}
}
No tienes que preocuparte sobre si el servidor soporta las variables de PHP $_SERVER
o $_ENV
, o acerca de valores por defecto o problemas de compatibilidad del servidor, ya que los métodos de 'sfWebRequest
lo hacen todo por tí. Además sus nombres son tan evidentes que no es necesario consultar la documentación de PHP para descubrir cómo obtener información sobre la petición.
Nota El código del ejemplo anterior utiliza como nombre del archivo el mismo nombre del archivo subido por el usuario. Existe la posibilidad de que un usuario malintencionado envíe un archivo con un nombre especialmente preparado para aprovechar algún agujero de seguridad, por lo que es recomendable que generes de forma automática y/o normalices el nombre de todos los archivos subidos.