2010-03-28 22:10:10 +00:00
|
|
|
<?xml version="1.0" encoding="utf-8"?>
|
2009-07-11 06:17:58 +00:00
|
|
|
<!-- $Revision$ -->
|
2007-06-20 22:25:43 +00:00
|
|
|
<sect1 xml:id="language.oop5.constants" xmlns="http://docbook.org/ns/docbook">
|
2005-08-03 18:21:30 +00:00
|
|
|
<title>Class Constants</title>
|
2004-07-10 19:30:37 +00:00
|
|
|
<para>
|
2004-08-07 18:05:14 +00:00
|
|
|
It is possible to define constant values on a per-class basis remaining the
|
|
|
|
same and unchangeable. Constants differ from normal variables in that you
|
2007-10-21 15:57:09 +00:00
|
|
|
don't use the <varname>$</varname> symbol to declare or use them.
|
2004-07-10 19:30:37 +00:00
|
|
|
</para>
|
2005-10-13 13:25:22 +00:00
|
|
|
<para>
|
|
|
|
The value must be a constant expression, not (for example) a variable, a
|
2009-09-10 05:07:22 +00:00
|
|
|
property, a result of a mathematical operation, or a function call.
|
2005-10-13 13:25:22 +00:00
|
|
|
</para>
|
2008-08-12 21:26:21 +00:00
|
|
|
<para>
|
2010-09-12 11:45:09 +00:00
|
|
|
It's also possible for interfaces to have <literal>constants</literal>. Look at
|
2008-08-12 21:26:21 +00:00
|
|
|
the <link linkend="language.oop5.interfaces">interface documentation</link> for
|
|
|
|
examples.
|
|
|
|
</para>
|
2007-10-21 15:57:09 +00:00
|
|
|
<para>
|
|
|
|
As of PHP 5.3.0, it's possible to reference the class using a variable.
|
2008-02-28 13:26:54 +00:00
|
|
|
The variable's value can not be a keyword (e.g. <literal>self</literal>,
|
|
|
|
<literal>parent</literal> and <literal>static</literal>).
|
2007-10-21 15:57:09 +00:00
|
|
|
</para>
|
2004-07-19 04:52:41 +00:00
|
|
|
<example>
|
|
|
|
<title>Defining and using a constant</title>
|
|
|
|
<programlisting role="php">
|
|
|
|
<![CDATA[
|
|
|
|
<?php
|
2004-10-02 09:40:52 +00:00
|
|
|
class MyClass
|
|
|
|
{
|
|
|
|
const constant = 'constant value';
|
2004-07-19 04:52:41 +00:00
|
|
|
|
2004-10-02 09:40:52 +00:00
|
|
|
function showConstant() {
|
|
|
|
echo self::constant . "\n";
|
|
|
|
}
|
2004-07-19 04:52:41 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
echo MyClass::constant . "\n";
|
|
|
|
|
2007-10-21 15:57:09 +00:00
|
|
|
$classname = "MyClass";
|
2008-01-17 19:06:08 +00:00
|
|
|
echo $classname::constant . "\n"; // As of PHP 5.3.0
|
2007-10-21 15:57:09 +00:00
|
|
|
|
2004-07-19 04:52:41 +00:00
|
|
|
$class = new MyClass();
|
|
|
|
$class->showConstant();
|
2007-10-21 15:57:09 +00:00
|
|
|
|
2008-03-06 16:46:37 +00:00
|
|
|
echo $class::constant."\n"; // As of PHP 5.3.0
|
2004-07-19 04:52:41 +00:00
|
|
|
?>
|
|
|
|
]]>
|
|
|
|
</programlisting>
|
|
|
|
</example>
|
2008-04-18 19:22:12 +00:00
|
|
|
|
|
|
|
<example>
|
|
|
|
<title>Static data example</title>
|
|
|
|
<programlisting role="php">
|
|
|
|
<![CDATA[
|
|
|
|
<?php
|
|
|
|
class foo {
|
|
|
|
// As of PHP 5.3.0
|
|
|
|
const bar = <<<'EOT'
|
|
|
|
bar
|
|
|
|
EOT;
|
|
|
|
}
|
|
|
|
?>
|
|
|
|
]]>
|
|
|
|
</programlisting>
|
|
|
|
<para>
|
|
|
|
Unlike heredocs, nowdocs can be used in any static data context.
|
|
|
|
</para>
|
|
|
|
</example>
|
|
|
|
<note>
|
|
|
|
<para>
|
|
|
|
Nowdoc support was added in PHP 5.3.0.
|
|
|
|
</para>
|
|
|
|
</note>
|
2004-07-10 19:30:37 +00:00
|
|
|
</sect1>
|
|
|
|
|
|
|
|
<!-- Keep this comment at the end of the file
|
|
|
|
Local variables:
|
|
|
|
mode: sgml
|
|
|
|
sgml-omittag:t
|
|
|
|
sgml-shorttag:t
|
|
|
|
sgml-minimize-attributes:nil
|
|
|
|
sgml-always-quote-attributes:t
|
|
|
|
sgml-indent-step:1
|
|
|
|
sgml-indent-data:t
|
|
|
|
indent-tabs-mode:nil
|
|
|
|
sgml-parent-document:nil
|
2009-09-25 07:04:39 +00:00
|
|
|
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
|
2004-07-10 19:30:37 +00:00
|
|
|
sgml-exposed-tags:nil
|
|
|
|
sgml-local-catalogs:nil
|
|
|
|
sgml-local-ecat-files:nil
|
|
|
|
End:
|
|
|
|
vim600: syn=xml fen fdm=syntax fdl=2 si
|
|
|
|
vim: et tw=78 syn=sgml
|
|
|
|
vi: ts=1 sw=1
|
|
|
|
-->
|