diff options
author | vlakoff <vlakoff@gmail.com> | 2015-01-21 22:56:51 +0100 |
---|---|---|
committer | vlakoff <vlakoff@gmail.com> | 2015-01-22 00:05:20 +0100 |
commit | 93d98b611051bf123532a0d30ebe97480ae4a3b4 (patch) | |
tree | 363e294c09d5c7e6045ae2b508eb7f8e52017d9f /user_guide_src/source/general/styleguide.rst | |
parent | 4cbe463b4c442e0e2dae2f43565e77f7ac5ecb86 (diff) |
Update documentation about PHP files closing
Diffstat (limited to 'user_guide_src/source/general/styleguide.rst')
-rw-r--r-- | user_guide_src/source/general/styleguide.rst | 27 |
1 files changed, 2 insertions, 25 deletions
diff --git a/user_guide_src/source/general/styleguide.rst b/user_guide_src/source/general/styleguide.rst index b27031a7b..7704a59c5 100644 --- a/user_guide_src/source/general/styleguide.rst +++ b/user_guide_src/source/general/styleguide.rst @@ -52,31 +52,8 @@ The PHP closing tag on a PHP document **?>** is optional to the PHP parser. However, if used, any whitespace following the closing tag, whether introduced by the developer, user, or an FTP application, can cause unwanted output, PHP errors, or if the latter are suppressed, -blank pages. For this reason, all PHP files should **OMIT** the closing -PHP tag, and instead use a comment block to mark the end of file and -its location relative to the application root. This allows you to still -identify a file as being complete and not truncated. - -**INCORRECT**:: - - <?php - - echo "Here's my code!"; - - ?> - -**CORRECT**:: - - <?php - - echo "Here's my code!"; - - /* End of file Myfile.php */ - /* Location: ./system/modules/mymodule/myfile.php */ - -.. note:: There should be no empty line or newline character(s) following - the closing comments. If you happen to see one when - submitting a pull request, please check your IDE settings and fix it. +blank pages. For this reason, all PHP files MUST OMIT the PHP closing +tag and end with a single empty line instead. File Naming =========== |