Last updated: Fri, 25 Jul 2008

Sintaxis básica

Saliendo de HTML

Para interpretar un archivo, php símplemente interpreta el texto del archivo hasta que encuentra uno de los carácteres especiales que delimitan el inicio de código PHP. El intérprete ejecuta entonces todo el código que encuentra, hasta que encuentra una etiqueta de fin de código, que le dice al intérprete que siga ignorando el código siguiente. Este mecanismo permite embeber código PHP dentro de HTML: todo lo que está fuera de las etiquetas PHP se deja tal como está, mientras que el resto se interpreta como código.

Hay cuatro conjuntos de etiquetas que pueden ser usadas para denotar bloques de código PHP. De estas cuatro, sólo 2 (<?php. . .?> y <script language="php">. . .</script>) están siempre disponibles; el resto pueden ser configuradas en el fichero de php.ini para ser o no aceptadas por el intérprete. Mientras que el formato corto de etiquetas (short-form tags) y el estilo ASP (ASP-style tags) pueden ser convenientes, no son portables como la versión de formato largo de etiquetas. Además, si se pretende embeber código PHP en XML o XHTML, será obligatorio el uso del formato <?php. . .?> para la compatibilidad con XML.

Las etiquetas soportadas por PHP son:

Example #1 Formas de escapar de HTML


1.  <?php echo("si quieres servir documentos XHTML o XML, haz como aqu&iacute;\n"); ?>

2.  <? echo ("esta es la m&aacute;s simple, una instrucci&oacute;n de procesado SGML \n"); ?>
    <?= expression ?> Esto es una abreviatura de "<? echo expression ?>"

3.  <script language="php">
        echo ("muchos editores (como FrontPage) no
              aceptan instrucciones de procesado");
    </script>

4.  <% echo ("Opcionalmente, puedes usar las etiquetas ASP"); %>
    <%= $variable; # Esto es una abreviatura de "<% echo . . ." %>

El método primero, <?php. . .?>, es el más conveniente, ya que permite el uso de PHP en código XML como XHTML.

El método segundo no siempre está disponible. El formato corto de etiquetas está disponible con la función short_tags() (sólo PHP 3), activando el parámetro del fichero de configuración de PHP short_open_tag, o compilando PHP con la opción --enable-short-tags del comando configure. Aunque esté activa por defecto en php.ini-dist, se desaconseja el uso del formato de etiquetas corto.

El método cuarto sólo está disponible si se han activado las etiquetas ASP en el fichero de configuración: asp_tags.

Note: El soporte de etiquetas ASP se añadió en la versión 3.0.4.

Note: No se debe usar el formato corto de etiquetas cuando se desarrollen aplicaciones o bibliotecas con intención de redistribuirlas, o cuando se desarrolle para servidores que no están bajo nuestro control, porque puede ser que el formato corto de etiquetas no esté soportado en el servidor. Para generar código portable y redistribuíble, asegúrate de no usar el formato corto de etiquetas.

La etiqueta de fin de bloque incluirá tras ella la siguiente línea si hay alguna presente. Además, la etiqueta de fin de bloque lleva implícito el punto y coma; no necesitas por lo tanto añadir el punto y coma final de la última línea del bloque PHP.

PHP permite estructurar bloques como:

Example #2 Métodos avanzados de escape


<?php
if ($expression) {
    ?>
    <strong>This is true.</strong>
    <?php
} else {
    ?>
    <strong>This is false.</strong>
    <?php
}
?>

Este ejemplo realiza lo esperado, ya que cuando PHP encuentra las etiquetas ?> de fin de bloque, empieza a escribir lo que encuentra tal cual hasta que encuentra otra etiqueta de inicio de bloque. El ejemplo anterior es, por supuesto, inventado. Para escribir bloques grandes de texto generamente es más eficiente separalos del código PHP que enviar todo el texto mediante las funciones echo(), print() o similares.

Separación de instrucciones

Referencia del lenguaje

Last updated: Fri, 25 Jul 2008

add a note User Contributed Notes
Sintaxis básica

mattsch at gmail dot com
25-Jun-2008 01:46


Less is more.  The shortest and easiest way to deal with the xml tag problem assuming short tags is enabled and you don't care to listen to people who want you to always use the full php tag is this:



<<??>?xml version="1.0" encoding="utf-8"?>

jesdisciple{ at t}gmail{d dot t}com
05-Mar-2008 09:21


@evanplaice at aol dot com: The <script language="php"> tag won't be read by browsers; it will be parsed by PHP just like <?php and ?> are.

evanplaice at aol dot com
30-Dec-2007 03:33


Correction for Example 2-2



The <script> "language" attribute has been deprecated



See: 

http://www.w3.org/TR/REC-html40/interact/scripts.html#h-18.2.1



This should be noted in the example to update to the current standards.

KOmaSHOOTER at gmx dot de
28-Dec-2007 07:36


you also can use this kind of syntax:



<?php if( condition ): ?>

  

<?php else: ?>

  

<?php endif; ?>

truepath at infiniteinjury dot org
15-Jul-2007 01:08


"This works as expected, because when PHP hits the ?> closing tags, it simply starts outputting whatever it finds"



This is worded very confusingly so if you think you know what's going on just ignore this (I knew how this had to work from ruby but this comment made me think I was confused).  To be clear the documentation is NOT saying that whenever the PHP *parser* hits the closing tag it starts outputting whatever if finds.  What they mean is that ?> acts just like a php instruction that outputs whatever text it finds until it sees a <?php

Tona at spikesource dot com
03-May-2007 03:22


Jascam: Try to find more resourceful information to make your point. Your lack of ability to understand more complex concepts is not enough to diminish such a popular language as PHP. Note also that php is not replacing html but complementing it.

madman
17-Apr-2007 08:45


As rosswilliams mentioned;  The example breaking in and out of the PHP tags doesn't "work as expected".  The manual and some comments mention that PHP "simply starts outputting whatever it finds..." any time a closing tag is encountered.  It would make sense to say instead - "...unless PHP is in the middle of a conditional statement; in which case it will only output the relevant block of HTML."



Some have said that using the 'echo' command is cleaner and more  efficient.  However, as the manual points out, the method of breaking out of PHP is more efficient when dealing with large sections of HTML.  Because there is less work for the parser.

Geekman at Textbook Torrents dot com
04-Mar-2007 05:19


Regarding the comment by rosswilliams at advocacytechnologies dot org:



Your suspicion is correct. The following all behave exactly the same:



<?php



// output the answer by escaping

if ($true_or_false) {

    ?>

    <p>The value of $true_or_false is true.</p>

    <?php

} else {

    ?>

    <p>The value of $true_or_false is false.</p>

    <?php

}



// use echo to do the same thing - more effecient and easier to read in my opinion

if ($true_or_false) {

    echo '<p>The value of $true_or_false is true.</p>';

} else {

    echo '<p>The value of $true_or_false is false.</p>';

}



// use ? : operators on entire string

echo ($true_or_false) ? '<p>The value of $true_or_false is true.</p>' : '<p>The value of $true_or_false is false.</p>';



// use ? : operators only on the pertinent bit, to save space

echo '<p>The value of $true_or_false is ' . (($true_or_false) ? 'true' : 'false') . '.</p>';



?>

rosswilliams at advocacytechnologies dot org
29-Dec-2006 11:14


"This works as expected, because when PHP hits the ?> closing tags, it simply starts outputting whatever it finds until it hits another opening tag."



I would suggest it is not clear what "works as expected" means. You may know what to expect. But as a new user I don't. 



The explanation would lead one to believe both phrases outside the php code would be outputted to the html document. I suspect that is not what happens, but I will need to go test it.

alfridus
23-Jul-2006 04:53


Only this work:



<?php 

$xml = '<?xml version="1.0" encoding="UTF-8" standalone="no"?>';

echo $xml;

 ?>



with space after '<?php' and before ' ?>', no spacing between

'<?xml' and a semicolon after '"no"?>';'.

php at pixo dot sk
04-Apr-2006 04:58


just for conclusion:



<?php echo('<?xml version="1.0" ?'.'>'); ?>



is the right choice :)

brettz9 at yahoo dot com
02-Apr-2006 08:04


I've essentially tried to synthesize this

discussion at 

http://en.wikibooks.org/wiki/Programming:

Complete_PHP/Escaping_from_HTML



One point not brought up yet...



The HEREDOC problem with some text editors

may be fixable in at least some text editors

by adding a comment with a quotation mark

as such afterwards (albeit necessarily on a

new line):



<?php



$version = "1.0";



print <<<HERE

<?xml version="

HERE;

//"



print $version."\"?>";



?>

Christoph
16-Jan-2006 05:08


Here's an inspiration on how to quickly fix all scripts relying on short_open_tag being enabled:



find -name '*.php' | xargs perl -pi -e 's/<\?= ?(.*?) ?\?>/<?php echo($1); ?>/g'

find -name '*.php' | xargs perl -pi -e 's/<\?/<?php/g'

find -name '*.php' | xargs perl -pi -e 's/<\?phpphp/<?php/g'

Michael Newton (http://mike.eire.ca/)
12-Dec-2005 03:17


The XML declaration does not need to be handled specially.



You should output it via an echo statement, in case your code is ever used on a server that is (poorly) configured to use short open tags.



But there's no need to treat the ?> at the end of the string specially.  That's because it's in a string.  The only thing PHP ever looks for in a string is \ or $ (the latter only in double-quoted strings.)



I have never had need for the following, as some have suggested below:



<?php

$xml=rawurldecode('%3C%3Fxml%20version%3D%221.0%22%3F%3E');

echo($xml);

?>



<?php echo '<?xml version="1.0" ?'.'>' ?>



<?php echo "<?xml version=\"1.0\"\x3F>" ?>

php [AT] jsomers [DOT] be
23-Sep-2005 12:37


PEAR states:



Always use <?php ?> to delimit PHP code, not the <? ?> shorthand. This is required for PEAR compliance and is also the most portable way to include PHP code on differing operating systems and setups.



It are these small things that enhance readability in group projects, or libraries.

pablo [] littleQ.net
24-Jul-2005 02:06


Just another more "feature" of IE...



Content-Disposition: attachment; filename=\"__FILE__\";



__FILE__ can't have spaces or :



Regards

01karlo at gmail dot com
25-Jun-2005 08:44


Or, use the following:



<?php

$xml=rawurldecode('%3C%3Fxml%20version%3D%221.0%22%3F%3E');

echo($xml);

?>



What is does it the value of the variable $xml is the RAW Url Encoded version of the XML thing.

Then it decodes it and echo it to the visitor.

p o r g e s at the gmail dot com server
01-Apr-2005 08:02


mike at skew dot org, I believe the differentiation is that "x"-"m"-"l" as a PI target is explicitly excluded from the definition of processing instructions.

Lachlan Hunt
28-Mar-2005 09:06


The person that suggested the use of this meta element above is wrong:



<meta http-equiv="Content-Type" content="application/xml+xhtml; charset=UTF-8" />



That meta element and the XML declaration serve completely different purposes, and that meta element should not be used.  Such information should be set using the HTTP Content-Type header (see the header() function).



Any XHTML page that just uses that meta element without proper HTTP Content-Type header, will be processed as text/html by browsers regardless, and when the HTTP headers do serve as application/xhtml+xml (or other XML MIME type), that charset parameter in the meta element will be ignored.

mike at skew dot org
21-Oct-2004 04:53


mart3862 mentions "XML processing instructions" and quotes their syntax from the spec, but is mistaken in using



<?xml version="1.0" ...?>



as an example. This little bit of markup that appears at the beginning of an XML file is in fact not a processing instruction at all; it is an "XML declaration" -- or, if it appears in an entity other than the main document, a "text declaration". All three constructs are formatted slightly differently, although they all do begin and end with the same.



The difference between a processing instruction, an XML declaration, or a text declaration is more than just a matter of subtle differences in syntax, though. A processing instruction embodies exactly two opaque, author-defined pieces of information (a 'target' and an 'instruction') that are considered to be part of the document's logical structure and that are thus made available to an application by the XML parser. An XML or text declaration, on the other hand, contains one to three specific pieces of information (version, encoding, standalone status), each with a well-defined meaning. This info provides cues to the parser to help it know how to read the file; it is not considered part of the document's logical structure and is not made available to the application.

stooges_cubed at racerx dot net
20-Oct-2004 01:13


In the note above about escaping XML/PHP style <?xml tags, the following code was used:





<?php  // Html safe containers





   echo <<<EOD


<?xml version="1.0"?>


...all sorts of XML goes here...


Nothing will affect the output of this code until:


EOD;


?>





EOD is just an example stop/start name.





This works too:





<?php  // Html safe containers





  $myOutput = <<<MYHTMLSAFEOUTPUT


<?xml version="1.0"?>


<html>


  <title>PHP Example</title>


  <body>


   <p>...all sorts goes here...</p>


  </body>


</html>


MYHTMLSAFEOUTPUT;





echo $myOutput;





?>





Only disadvantage of using this is that all the code highlighting programs I've seen never get it right, making your code look eronous in the majority of viewers.





Another alternative is to keep the XML / HTML in a separate include file and read in when needed. I don't know how efficient/inefficient this is for (idiots like yourselves) small amounts of text.





xmlheader.txt:


<?xml version="1.0"?>





mypage.php:


<?php


  include("xmlheader.txt");


?>

crtrue at coastal dot edu
30-Apr-2004 11:02


Although you can use the above methods to pass a document off as a valid for the W3C parser, a simpler-and-perfectly-legal method of doing so is to simple declare the document type in a meta tag. Something along these lines (mind the values in 'content' - I haven't personally used the Content-Type method in awhile):



<meta http-equiv="Content-Type" content="application/xml+xhtml; charset=UTF-8" />



Of course if you're using just XML, and don't use such functions, then the above methods will work just as fine.

mart3862 at yahoo dot com dot au
18-Apr-2004 09:29


Now the ultimate truth on how you should output xml processing instructions:



There have been several posts suggesting ways to include the text <?xml version="1.0" encoding="utf-8"?> in your output when short_tags is turned on, but only the following should be used:



<?php echo '<?xml version="1.0" ?'.'>' ?>

or

<?php echo "<?xml version=\"1.0\"\x3F>" ?>



Using one of these methods, and not making use of short tags, means your source code will also be a valid XML document, which allows you to do many things with it such as validation, XSLT translations, etc, as well as allowing your text editor to parse your code for syntax colouring.  Every PHP tag will simply be interpreted as an XML processing instruction (commonly referred to as PI).



The reason why all the other suggested methods are not advisable is because they contain the characters ?> inside the PHP tag, which the XML parser will interpret as the end of the processing instruction.



A processing instruction is defined in XML as:



PI ::= '<?' PITarget (S (Char* - (Char* '?>' Char*)))? '?>' 



In other words, it explicitly forbids the characters ?> to occur together within a processing instruction, unless they are delimiting the end of the tag.  It also requires a PITarget (an identifier starting with a letter) immediately after the initial start delimiter, which means that all short tag formats are also invalid XML.



Following these guidelines will result in code that is portable to servers with any configuration and allow you perform many useful tasks on your XML or XHTML source documents.  Even if you do not intend to validate or translate your source documents, and you can ignore some incorrect syntax colouring in your text editor, it is still best to get into good habits early.

Anon
21-Feb-2004 06:05


Yet another way of adding the XML processing instruction is to use:



<?php echo '<?xml version="1.0" ?'.'>' ?>



Because the ? and > are separated, the parser will not terminate before it is supposed to.



As a side note, the W3C's parser seems to recognise this method (assuming it even checks for the PI).

TarquinWJ
06-Feb-2004 06:54


Not spotted any messages like this one - delete it if there was one.



My hosting service allows <? and ?>, but I like to use valid XHTML, so I came up with this simple solution:



It is possible to use the short tags <? ?> with XHTML or XML documents. The only problem is that X(HT)ML requires a declaration using <? and ?>



<?xml version="1.0" encoding="UTF-8"?>



To avoid the problem, simply replace <? with <<? ?>?

and ?> with ?<? ?>>



<<? ?>?xml version="1.0" encoding="UTF-8"?<? ?>>



This inserts a blank piece of PHP in between the < and ?, and when parsed will output the regular tag

<?xml version="1.0" encoding="UTF-8"?>

mwild at iee dot NO_SP_AM dot org
19-Dec-2003 05:12


The text between <script> and </script> in XHTML is PCDATA, so <  and & characters in it should be interpreted as markup. This is a bit limiting for PHP, which is often used to output tags, though you can of course use &lt; and &amp; instead. To avoid that, which makes your code look peculiar and is easy to forget to do, you can mark the PHP as CDATA, eg :



<script language="PHP">

//<![CDATA[ 

echo('Today is <b>'.date('l F jS').'</b>');

//]]>

</script>



If you don't do this, and your code contains < or &, it should be rejected by an XHTML validator.

johnbeech at (not saying) mkv25 dot net
07-Dec-2003 04:42


In the note above about escaping XML/PHP style <?xml tags, the following code was used:



<?php  // Html safe containers



   echo <<<EOD

<?xml version="1.0"?>

...all sorts of XML goes here...

Nothing will affect the output of this code until:

   EOD;

?>



EOD is just an example stop/start name.



This works too:



<?php  // Html safe containers



  $myOutput = <<<MYHTMLSAFEOUTPUT

<?xml version="1.0"?>

<html>

  <title>PHP Example</title>

  <body>

    <p>...all sorts goes here...</p>

  </body>

</html>

MYHTMLSAFEOUTPUT;



echo $myOutput;



?>



Only disadvantage of using this is that all the code highlighting programs I've seen never get it right, making your code look eronous in the majority of viewers.



Another alternative is to keep the XML / HTML in a separate include file and read in when needed. I don't know how efficient/inefficient this is for small amounts of text.



xmlheader.txt:

<?xml version="1.0"?>



mypage.php:

<?php

  include("xmlheader.txt");

?>

dave at [nospam] dot netready dot biz
18-Mar-2002 04:21


A little "feature" of PHP I've discovered is that the <?PHP token requires a space after it whereas after the <? and <% tokens a space is optional.



The error message you get if you miss the space is not too helpful so be warned!



(These examples only give a warning with error_reporting(E_ALL) )



<?PHP/*<Some HTML>*/?> fails...

<?/*<Some HTML>*/?> works...

mrtidy at mail dot com
12-Dec-2001 12:36


[Ed Note:


This is because of short_tags, <?xml turns php parsing on, because of the <?.


--irc-html@php.net]





I am moving my site to XHTML and I ran into trouble with the <?xml ?> interfering with the <?php ?> method of escaping for HTML.  A quick check of the mailing list confirmed that the current preferred method to cleanly output the <?xml ?> line is to echo it:<br>


<?php echo("<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"); ?>

add a note

Separación de instrucciones

Referencia del lenguaje

Last updated: Fri, 25 Jul 2008

Sintaxis básica

Table of Contents

Saliendo de HTML