| <?xml version="1.0"?> | |
| <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> | |
| <?xml-stylesheet type="text/xsl" href="../style/manual.es.xsl"?> | |
| <!-- English Revision: 1673932 --> | |
| <!-- Spanish Translation: Daniel Ferradal <dferradal@apache.org> --> | |
| <!-- | |
| Licensed to the Apache Software Foundation (ASF) under one or more | |
| contributor license agreements. See the NOTICE file distributed with | |
| this work for additional information regarding copyright ownership. | |
| The ASF licenses this file to You under the Apache License, Version 2.0 | |
| (the "License"); you may not use this file except in compliance with | |
| the License. You may obtain a copy of the License at | |
| http://www.apache.org/licenses/LICENSE-2.0 | |
| Unless required by applicable law or agreed to in writing, software | |
| distributed under the License is distributed on an "AS IS" BASIS, | |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
| See the License for the specific language governing permissions and | |
| limitations under the License. | |
| --> | |
| <modulesynopsis metafile="mod_asis.xml.meta"> | |
| <name>mod_asis</name> | |
| <description>Envía ficheros que contienen sus propias | |
| cabeceras HTTP</description> | |
| <status>Base</status> | |
| <sourcefile>mod_asis.c</sourcefile> | |
| <identifier>asis_module</identifier> | |
| <summary> | |
| <p>Este módulo provee el handler <code>send-as-is</code> | |
| que hace que Apache HTTP Server envíe documentos sin añadir a ellos la | |
| mayoría de las cabeceras típicas de HTTP.</p> | |
| <p>Esto se puede usar para enviar cualquier tipo de datos desde el servidor, | |
| incluyendo redirecciones y otras respuestas HTTP especiales, sin | |
| necesitar un script-cgi o un script nph.</p> | |
| <p>Por razones históricas, este módulo también procesará cualquier fichero | |
| con el tipo MIME <code>httpd/send-as-is</code>.</p> | |
| </summary> | |
| <seealso><module>mod_headers</module></seealso> | |
| <seealso><module>mod_cern_meta</module></seealso> | |
| <seealso><a href="../handler.html">Uso de Handler de Apache httpd</a></seealso> | |
| <section id="usage"><title>Uso</title> | |
| <p>En el fichero de configuración del servidor, asociar ficheros con el | |
| handler <code>send-as-is</code> <em>p. ej.</em></p> | |
| <highlight language="config"> | |
| AddHandler send-as-is asis | |
| </highlight> | |
| <p>Los contenidos de cualquier fichero con la extensión <code>.asis</code> | |
| se enviarán por Apache httpd al cliente sin apenas cambios. En particular, | |
| las cabeceras HTTP provienen del propio fichero según las reglas de | |
| <module>mod_cgi</module>, así que un fichero "asis" debe incluir cabeceras | |
| válidas, y también puede usar la cabecera CGI | |
| <code>Status:</code> para determinar el código de la respuesta HTTP. La | |
| cabecera <code>Content-Length:</code> se insertará automáticamente, o si se | |
| incluye en el fichero, será corregida por httpd.</p> | |
| <p>Aquí hay un ejemplo de un fichero cuyo contenido se envía | |
| <em>as is</em> (tal cual) para decirle al cliente que | |
| un fichero se ha redirigido.</p> | |
| <example> | |
| Status: 301 Y ahora donde he dejado esa URL<br /> | |
| Location: http://xyz.example.com/foo/bar.html<br /> | |
| Content-type: text/html<br /> | |
| <br /> | |
| <html><br /> | |
| <head><br /> | |
| <title>Excusas flojas'R'us</title><br /> | |
| </head><br /> | |
| <body><br /> | |
| <h1>La excepcionalmente maravillosa página de Fred's se ha movido a<br /> | |
| <a href="http://xyz.example.com/foo/bar.html">Joe's</a> | |
| site.<br /> | |
| </h1><br /> | |
| </body><br /> | |
| </html> | |
| </example> | |
| <note><title>Notas:</title> | |
| <p>El servidor siempre añade una cabecera <code>Date:</code> y | |
| <code>Server:</code> a los datos que se devuelven al cliente, de manera que | |
| estos no deben incluirse en el fichero. El servidor <em>no</em> añade una | |
| cabecera <code>Last-Modified</code> ; probablemente debería.</p> | |
| </note> | |
| </section> | |
| </modulesynopsis> |