Note: You are currently viewing documentation for Moodle 3.7. Up-to-date documentation for the latest stable version of Moodle may be available here: PHP.

PHP: Difference between revisions

From MoodleDocs
No edit summary
 
(40 intermediate revisions by 18 users not shown)
Line 1: Line 1:
PHP is the scripting language in which Moodle is developed. PHP does not stand alone, it is tightly integrated with a suitable HTTP Server. Most people use the [[Apache]] HTTP Server for this purpose although a number of others are supported.
{{Installing Moodle}}
PHP is the scripting language in which Moodle is developed. It is integrated with your web server. The web server detects php pages (by their extension) and sends them to PHP for execution. PHP must be installed and configured properly for Moodle to work effectively (or at all).


PHP describes itself as "a widely-used general-purpose scripting language that is especially suited for Web development and can be embedded into [[HTML]]."
==PHP Versions==
* Moodle 3.0.1 and later support PHP 7, however
** Moodle 3.1 and earlier does not support PHP 7.1 or later (this means that there is currently no combination of releases of Moodle and PHP that are still supported before Moodle 3.4);
* Moodle 3.4 and Moodle 3.5 '''require''' PHP 7.0 or PHP 7.1 or PHP 7.2
* Moodle 3.6 '''requires''' PHP 7.0 or later
* Moodle 3.7 and later '''require''' PHP 7.1 or later


== See also ==
==PHP Settings==
Check these settings in your php.ini or .htaccess file (if you're using Apache). For settings which use ON/OFF as their values, you can substitute 1 for ON and 0 for OFF if you prefer. If you change php.ini, don't forget to restart the server.
* ''memory_limit'' needs to be at least 96M (although some functions may not work if this low).  Moodle will refuse to install if lower. 128M is recommended. Large systems may need an even higher setting.
* ''session.save_handler'' needs to be set to FILES.
* ''magic_quotes_runtime'' needs to be OFF. (DEPRECATED in PHP 5.3.0, and REMOVED as of PHP 7.0.0.)
* ''file_uploads'' needs to be ON.
* ''session.auto_start'' needs to be OFF.
* The temp folder must be defined and writeable by your webserver user
* Check the error display/logging section. Make sure the settings are appropriate for your server use.
* ''post_max_size'' and ''upload_max_filesize'' restrict the maximum file size that can be uploaded.
* Check the ''[mail function]'' and database section (for your chosen database) to make sure they match your server configuration.


* [http://www.php.net/ The PHP home page]
==HTTP_RAW_POST_DATA errors==
* [http://en.wikipedia.org/wiki/PHP Wikipedia article on PHP]
Some users are experiencing $HTTP_RAW_POST_DATA related errors, when establishing connection between MNET servers or making AJAX web services requests.
<pre>
Request for server name returned empty response
    line 134 of /mnet/lib.php: call to debugging()
    line 115 of /admin/mnet/peers.php: call to mnet_get_public_key()
</pre>


These errors are affecting installations running moodle on PHP 5.6 version and it's a PHP bug on the '''always_populate_raw_post_data''' setting the default value to 0.


[[Category:Administrator]]
To avoid the error messages above, please change the value following setting on your php.ini file:
[[Category:Developer]]
* '''always_populate_raw_post_data''' should be changed to '''-1'''.


{{stub}}
For more information about this bug, see: https://bugs.php.net/bug.php?id=66763
 
==Finding the correct php.ini==
Sometimes it is not obvious where the php.ini file is located or you may even find more than one. To be certain run 'phpinfo' - see below. The path of the php.ini file is a few lines down in the top section.
 
Note that if you are using command-line (CLI) PHP for running cron (or anything else) it may be configured with a ''different'' php.ini file.  To check, run the following command:
<pre>
php -i | grep php.ini
</pre>
 
==PHP Extensions and libraries==
The following PHP extensions are required or recommended (some, e.g. iconv, ctype and tokenizer are now included in PHP by default). Others will need to be installed or selected.
* The '''iconv''' extension is required.
* The '''mbstring''' extension is recommended.
* The '''curl''' extension is required (required for networking and web services).
* The '''openssl''' extension is recommended (required for networking and web services).
* The '''tokenizer''' extension is recommended.
* The '''xmlrpc''' extension is recommended (required for networking and web services).
* The '''soap''' extension is recommended (required for web services).
* The '''ctype''' extension is required.
* The '''zip''' extension is required.
* The '''gd''' extension is recommended (required for manipulating images).
* The '''simplexml''' extension is required.
* The '''spl''' extension is required.
* The '''pcre''' extension is required.
* The '''dom''' extension is required.
* The '''xml''' extension is required.
* The '''intl''' extension is recommended.
* The '''json''' extension is required.
* '''The appropriate extension for your chosen database is also required.'''
 
* Other PHP extensions may be required to support optional Moodle functionality, especially external authentication and/or enrolment (e.g. LDAP extension for LDAP authentication and the sockets extension for Chat server).
 
==Installing (missing) extensions==
 
This depends on how PHP was installed on your machine and what access you have. Here are some possibilities:
* If this is a hosted server you are likely to have to ask the administrator or hosting company.
* If PHP was compiled from source you will need to recompile, changing the 'configure' settings - see [[Compiling PHP from source]].
* If it was installed using packages (typically Linux) you can install the required package (see your Linux distribution's documentation)
* If you are using Windows you just need to uncomment the appropriate DLL files in php.ini
 
After making any changes or additions, don't forget to re-start your web server.
 
== .htaccess files ==
 
If you don't have access to the php.ini file or there are conflicting requirements with other PHP applications on the same server you may be able to change PHP settings in an .htaccess file. This should be placed in the 'root' of your Moodle installation (i.e. the same place as the config.php file).
 
'''The file isn't always called .htaccess and may not work at all. Contact your server administrator to be sure'''
 
Settings are made by adding lines in one of two formats:
* php_value ''name value''
* php_flag ''name on/off''
 
Examples:
* '''php_value memory_limit 128M'''
* '''php_flag register_globals off'''
 
==PHP info==
 
The phpinfo display contains information about the configuration of your PHP installation. This is useful for checking:
* that your PHP installation meets Moodle's system requirements.
* the values that are currently applied to your server's PHP install, e.g. File upload limits
* that you have installed the required modules needed for Moodle to work, e.g. the LDAP module for LDAP authentication.
 
=== Displaying phpinfo in Moodle===
 
An administrator can find PHP info in ''Settings > Site administration > Server > PHP info''.
 
=== Displaying phpinfo outside of Moodle ===
 
To view the phpinfo information:
* Create a file called info.php using your text editor, containing this single line:
 
<code php>
<?php phpinfo(); ?>
</code>
 
* Save this file as info.php
* Upload this file into the root web accessible folder on your server.
* Now open this file in your browser. For example <nowiki>http://<server-name>/info.php</nowiki>.
 
==See also==
 
*[[Compiling PHP from source]]
* [https://docs.moodle.org/dev/Moodle_and_PHP7 Moodle and PHP7] in the developers documentation
*http://www.php.net/ - the PHP web site
*http://php.iis.net/ - Microsoft PHP Installer for IIS
* [[MoodleDocs:Style_guide#PHP_syntax_highlighting]] to highlight PHP syntax
* [[Code syntax highlighting]] that uses the GeSHi (Generic Syntax Highlighter) filter.
 
[[de:PHP]]
[[es:PHP]]

Latest revision as of 21:46, 15 July 2019

PHP is the scripting language in which Moodle is developed. It is integrated with your web server. The web server detects php pages (by their extension) and sends them to PHP for execution. PHP must be installed and configured properly for Moodle to work effectively (or at all).

PHP Versions

  • Moodle 3.0.1 and later support PHP 7, however
    • Moodle 3.1 and earlier does not support PHP 7.1 or later (this means that there is currently no combination of releases of Moodle and PHP that are still supported before Moodle 3.4);
  • Moodle 3.4 and Moodle 3.5 require PHP 7.0 or PHP 7.1 or PHP 7.2
  • Moodle 3.6 requires PHP 7.0 or later
  • Moodle 3.7 and later require PHP 7.1 or later

PHP Settings

Check these settings in your php.ini or .htaccess file (if you're using Apache). For settings which use ON/OFF as their values, you can substitute 1 for ON and 0 for OFF if you prefer. If you change php.ini, don't forget to restart the server.

  • memory_limit needs to be at least 96M (although some functions may not work if this low). Moodle will refuse to install if lower. 128M is recommended. Large systems may need an even higher setting.
  • session.save_handler needs to be set to FILES.
  • magic_quotes_runtime needs to be OFF. (DEPRECATED in PHP 5.3.0, and REMOVED as of PHP 7.0.0.)
  • file_uploads needs to be ON.
  • session.auto_start needs to be OFF.
  • The temp folder must be defined and writeable by your webserver user
  • Check the error display/logging section. Make sure the settings are appropriate for your server use.
  • post_max_size and upload_max_filesize restrict the maximum file size that can be uploaded.
  • Check the [mail function] and database section (for your chosen database) to make sure they match your server configuration.

HTTP_RAW_POST_DATA errors

Some users are experiencing $HTTP_RAW_POST_DATA related errors, when establishing connection between MNET servers or making AJAX web services requests.

Request for server name returned empty response
 
    line 134 of /mnet/lib.php: call to debugging()
    line 115 of /admin/mnet/peers.php: call to mnet_get_public_key()

These errors are affecting installations running moodle on PHP 5.6 version and it's a PHP bug on the always_populate_raw_post_data setting the default value to 0.

To avoid the error messages above, please change the value following setting on your php.ini file:

  • always_populate_raw_post_data should be changed to -1.

For more information about this bug, see: https://bugs.php.net/bug.php?id=66763

Finding the correct php.ini

Sometimes it is not obvious where the php.ini file is located or you may even find more than one. To be certain run 'phpinfo' - see below. The path of the php.ini file is a few lines down in the top section.

Note that if you are using command-line (CLI) PHP for running cron (or anything else) it may be configured with a different php.ini file. To check, run the following command:

php -i | grep php.ini

PHP Extensions and libraries

The following PHP extensions are required or recommended (some, e.g. iconv, ctype and tokenizer are now included in PHP by default). Others will need to be installed or selected.

  • The iconv extension is required.
  • The mbstring extension is recommended.
  • The curl extension is required (required for networking and web services).
  • The openssl extension is recommended (required for networking and web services).
  • The tokenizer extension is recommended.
  • The xmlrpc extension is recommended (required for networking and web services).
  • The soap extension is recommended (required for web services).
  • The ctype extension is required.
  • The zip extension is required.
  • The gd extension is recommended (required for manipulating images).
  • The simplexml extension is required.
  • The spl extension is required.
  • The pcre extension is required.
  • The dom extension is required.
  • The xml extension is required.
  • The intl extension is recommended.
  • The json extension is required.
  • The appropriate extension for your chosen database is also required.
  • Other PHP extensions may be required to support optional Moodle functionality, especially external authentication and/or enrolment (e.g. LDAP extension for LDAP authentication and the sockets extension for Chat server).

Installing (missing) extensions

This depends on how PHP was installed on your machine and what access you have. Here are some possibilities:

  • If this is a hosted server you are likely to have to ask the administrator or hosting company.
  • If PHP was compiled from source you will need to recompile, changing the 'configure' settings - see Compiling PHP from source.
  • If it was installed using packages (typically Linux) you can install the required package (see your Linux distribution's documentation)
  • If you are using Windows you just need to uncomment the appropriate DLL files in php.ini

After making any changes or additions, don't forget to re-start your web server.

.htaccess files

If you don't have access to the php.ini file or there are conflicting requirements with other PHP applications on the same server you may be able to change PHP settings in an .htaccess file. This should be placed in the 'root' of your Moodle installation (i.e. the same place as the config.php file).

The file isn't always called .htaccess and may not work at all. Contact your server administrator to be sure

Settings are made by adding lines in one of two formats:

  • php_value name value
  • php_flag name on/off

Examples:

  • php_value memory_limit 128M
  • php_flag register_globals off

PHP info

The phpinfo display contains information about the configuration of your PHP installation. This is useful for checking:

  • that your PHP installation meets Moodle's system requirements.
  • the values that are currently applied to your server's PHP install, e.g. File upload limits
  • that you have installed the required modules needed for Moodle to work, e.g. the LDAP module for LDAP authentication.

Displaying phpinfo in Moodle

An administrator can find PHP info in Settings > Site administration > Server > PHP info.

Displaying phpinfo outside of Moodle

To view the phpinfo information:

  • Create a file called info.php using your text editor, containing this single line:

<?php phpinfo(); ?>

  • Save this file as info.php
  • Upload this file into the root web accessible folder on your server.
  • Now open this file in your browser. For example http://<server-name>/info.php.

See also