Skip to content

Enable runnable (WASM) examples for language sections: constants, exceptions, expressions #5456

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
AllenJB wants to merge 2 commits into
base: master
Choose a base branch
from
+33 −41
Open

Enable runnable (WASM) examples for language sections: constants, exceptions, expressions #5456

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1032d7d
Enable runnable (WASM) examples for language sections: constants, exc…
AllenJB Apr 2, 2026
34e63b3
Enable runnable (WASM) examples for language sections: constants, exc…
AllenJB Apr 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 8 additions & 12 deletions language/constants.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<chapter xml:id="language.constants" xmlns="http://docbook.org/ns/docbook">
<chapter xml:id="language.constants" xmlns="http://docbook.org/ns/docbook" annotations="interactive">
<title>Constants</title>

<simpara>
Expand Down Expand Up @@ -36,7 +36,7 @@
<!-- TODO Move into syntax section? -->
<example>
<title>Valid and invalid constant names</title>
<programlisting role="php">
<programlisting role="php" annotations="non-interactive">
<![CDATA[
<?php

Expand All @@ -52,8 +52,6 @@ define("2FOO", "something");
// PHP may one day provide a magical constant
// that will break your script
define("__FOO__", "something");

?>
]]>
</programlisting>
</example>
Expand Down Expand Up @@ -178,7 +176,6 @@ define("CONSTANT", "Hello world.");
echo CONSTANT; // outputs "Hello world."
echo Constant; // Emits an Error: Undefined constant "Constant"
// Prior to PHP 8.0.0, outputs "Constant" and issues a warning.
?>
]]>
</programlisting>
</example>
Expand All @@ -193,23 +190,22 @@ echo Constant; // Emits an Error: Undefined constant "Constant"
// Simple scalar value
const CONSTANT = 'Hello World';

echo CONSTANT;
echo CONSTANT . "\n";

// Scalar expression
const ANOTHER_CONST = CONSTANT.'; Goodbye World';
echo ANOTHER_CONST;
const ANOTHER_CONST = CONSTANT . '; Goodbye World';
echo ANOTHER_CONST . "\n";

const ANIMALS = array('dog', 'cat', 'bird');
echo ANIMALS[1]; // outputs "cat"
echo ANIMALS[1] . "\n"; // outputs "cat"

// Constant arrays
define('ANIMALS', array(
define('ANIMALS_DEF', array(
'dog',
'cat',
'bird'
));
echo ANIMALS[1]; // outputs "cat"
?>
echo ANIMALS_DEF[1] . "\n"; // outputs "cat"
]]>
</programlisting>
</example>
Expand Down
37 changes: 12 additions & 25 deletions language/exceptions.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<chapter xml:id="language.exceptions" xmlns="http://docbook.org/ns/docbook">
<chapter xml:id="language.exceptions" xmlns="http://docbook.org/ns/docbook" annotations="interactive">
<title>Exceptions</title>
<note>
<simpara>See also the <exceptionname>Exception</exceptionname> class</simpara>
</note>
<para>
PHP has an exception model similar to that of other programming
languages. An exception can be &throw;n, and caught ("&catch;ed") within
Expand Down Expand Up @@ -112,15 +115,14 @@
</para>
<example>
<title>Converting error reporting to exceptions</title>
<programlisting role="php">
<programlisting role="php" annotations="non-interactive">
<![CDATA[
<?php
function exceptions_error_handler($severity, $message, $filename, $lineno) {
throw new ErrorException($message, 0, $severity, $filename, $lineno);
}

set_error_handler('exceptions_error_handler');
?>
]]>
</programlisting>
</example>
Expand Down Expand Up @@ -158,7 +160,6 @@ try {

// Continue execution
echo "Hello World\n";
?>
]]>
</programlisting>
&example.outputs;
Expand Down Expand Up @@ -200,7 +201,6 @@ try {

// Continue execution
echo "Hello World\n";
?>
]]>
</programlisting>
&example.outputs;
Expand Down Expand Up @@ -231,7 +231,6 @@ function test() {
}

echo test();
?>
]]>
</programlisting>
&example.outputs;
Expand Down Expand Up @@ -266,8 +265,6 @@ class Test {

$foo = new Test;
$foo->testing();

?>
]]>
</programlisting>
&example.outputs;
Expand Down Expand Up @@ -299,8 +296,6 @@ class Test {

$foo = new Test;
$foo->testing();

?>
]]>
</programlisting>
&example.outputs;
Expand Down Expand Up @@ -328,7 +323,6 @@ try {
} catch (SpecificException) {
print "A SpecificException was thrown, but we don't care about the details.";
}
?>
]]>
</programlisting>
&example.outputs;
Expand Down Expand Up @@ -358,7 +352,6 @@ try {
} catch (Exception $e) {
print $e->getMessage();
}
?>
]]>
</programlisting>
&example.outputs;
Expand Down Expand Up @@ -406,12 +399,12 @@ string(6) "Fourth"
<title>Extending Exceptions</title>
<para>
A User defined Exception class can be defined by extending the built-in
Exception class. The members and properties below, show what is accessible
<exceptionname>Exception</exceptionname> class. The members and properties below, show what is accessible
within the child class that derives from the built-in Exception class.
</para>
<example>
<title>The Built in Exception class</title>
<programlisting role="php">
<programlisting role="php" annotations="non-interactive">
<![CDATA[
<?php
class Exception implements Throwable
Expand Down Expand Up @@ -439,12 +432,11 @@ class Exception implements Throwable
// Overrideable
public function __toString(); // formatted string for display
}
?>
]]>
</programlisting>
</example>
<para>
If a class extends the built-in Exception class and re-defines the <link
If a class extends the built-in <exceptionname>Exception</exceptionname> class and re-defines the <link
linkend="language.oop5.decon">constructor</link>, it is highly recommended
that it also call <link
linkend="language.oop5.paamayim-nekudotayim">parent::__construct()</link>
Expand Down Expand Up @@ -521,7 +513,7 @@ class TestException
}


// Example 1
echo "# Example 1\n";
try {
$o = new TestException(TestException::THROW_CUSTOM);
} catch (MyException $e) { // Will be caught
Expand All @@ -533,10 +525,9 @@ try {

// Continue execution
var_dump($o); // Null
echo "\n\n";


// Example 2
echo "\n\n# Example 2\n";
try {
$o = new TestException(TestException::THROW_DEFAULT);
} catch (MyException $e) { // Doesn't match this type
Expand All @@ -548,10 +539,9 @@ try {

// Continue execution
var_dump($o); // Null
echo "\n\n";


// Example 3
echo "\n\n# Example 3\n";
try {
$o = new TestException(TestException::THROW_CUSTOM);
} catch (Exception $e) { // Will be caught
Expand All @@ -560,10 +550,9 @@ try {

// Continue execution
var_dump($o); // Null
echo "\n\n";


// Example 4
echo "\n\n# Example 4\n";
try {
$o = new TestException();
} catch (Exception $e) { // Skipped, no exception
Expand All @@ -572,8 +561,6 @@ try {

// Continue execution
var_dump($o); // TestException
echo "\n\n";
?>
]]>
</programlisting>
</example>
Expand Down
17 changes: 13 additions & 4 deletions language/expressions.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<chapter xml:id="language.expressions" xmlns="http://docbook.org/ns/docbook">
<chapter xml:id="language.expressions" xmlns="http://docbook.org/ns/docbook" annotations="interactive">
<title>Expressions</title>
<simpara>
Expressions are the most important building blocks of PHP. In PHP,
Expand All @@ -26,7 +26,7 @@
Slightly more complex examples for expressions are functions. For
instance, consider the following function:
<informalexample>
<programlisting role="php">
<programlisting role="php" annotations="non-interactive">
<![CDATA[
<?php
function foo ()
Expand Down Expand Up @@ -135,7 +135,7 @@ function foo ()
</para>
<para>
<informalexample>
<programlisting role="php">
<programlisting role="php" annotations="non-interactive">
<![CDATA[
<?php
$first ? $second : $third
Expand All @@ -161,24 +161,33 @@ $first ? $second : $third
<?php
function double($i)
{
return $i*2;
return $i * 2;
}

$b = $a = 5; /* assign the value five into the variable $a and $b */
$c = $a++; /* post-increment, assign original value of $a
(5) to $c */
print "a = {$a}; b = {$b}; c = {$c}" . PHP_EOL;

$e = $d = ++$b; /* pre-increment, assign the incremented value of
$b (6) to $d and $e */
print "b = {$b}; d = {$d}; e = {$e}" . PHP_EOL;

/* at this point, both $d and $e are equal to 6 */

$f = double($d++); /* assign twice the value of $d before
the increment, 2*6 = 12 to $f */
print "d = {$d}; f = {$f}" . PHP_EOL;

$g = double(++$e); /* assign twice the value of $e after
the increment, 2*7 = 14 to $g */
print "e = {$e}; g = {$g}" . PHP_EOL;

$h = $g += 10; /* first, $g is incremented by 10 and ends with the
value of 24. the value of the assignment (24) is
then assigned into $h, and $h ends with the value
of 24 as well. */
print "g = {$g}; h = {$h}" . PHP_EOL;
?>
]]>
</programlisting>
Expand Down