Last updated April 22, 2015. Created on September 13, 2012.
Edited by Mixologic, akalata, neclimdul, naught101. Log in to edit this page.

Below you find some additional notes regarding the PHP requirements for Drupal. Individual modules may have specific requirements and configurations needed, please double check module documentation as well. Within the Drupal interface, it is highly recommended that caching be enabled under admin/config/development/performance. This will help increase the performance of your Drupal installation and the end user experience. For more details see Caching to improve performance.

On this page:

PHP from different sources

Drupal is designed to work with PHP as distributed on Every effort is made to make it work with PHP versions from other sources but this is only done on a best effort basis. In particular, suhosin is known to break certain features and some operating systems move core components into other packages.

File and Folder Permissions

Drupal and PHP should have read and write access to the /sites/default/files directory. This area is used to store cached files (compressed CSS and JavaScript) and any file uploads through the Drupal interface. The exact permissions of this directory depend on how your PHP installation is configured. Generally speaking, read-write-execute for all, nobody user, (777) is not recommended as a security risk. PHP can be run under as the specific user account on the server using suPHP rather than a generic user (www) or nobody.

PHP Configuration Settings

PHP needs the following configuration directives for Drupal to work (only directives that differ from the default php.ini-dist / php.ini-recommended):

  • error_reporting set to E_ALL & ~E_NOTICE. Work is ongoing to change this to E_ALL for Drupal 6 and Drupal 7.
  • safe_mode: off. Safe mode may interfere with file and image uploads. This is applicable for only for PHP version's below 5.3.0, as of PHP 5.4.0 Safe Mode has been removed
  • Tokenizer functions require the tokenizer extension to be enabled. (Read more #357970: Undefined function token_get_all)

Setting: session.cache_limiter = nocache

Setting: session.auto_start = 0

Setting: expose_php = off
Reason: Shows current PHP version in all header requests, security disclosure, see here
Example: X-Powered-By: PHP/5.3.8

Setting: allow_url_fopen = off
Reason: This is a security issue: see here

Setting: magic_quotes_gpc = off
Reason: Forces quotes in variables - This feature has been deprecated as of PHP 5.3.0 and removed as of PHP 5.4.0.

Setting: register_globals = off
Reason: Security issue - having this enabled subjects PHP variables to input from any source:
This feature has been deprecated as of PHP 5.3.0 and removed as of PHP 5.4.0.

Setting: display_errors = Off
Reason: Hides errors output to display (website) we want to send to log file instead.

Memory requirements

PHP memory requirements can vary significantly depending on the modules in use on your site.

  • Drupal 6 core requires PHP's memory_limit to be at least 16MB.
  • Drupal 7 core requires 32MB.
  • Drupal 8 core requirements are in flux, but setting to 128 MB should be enough. See issue.

Note that Drupal 8 uses extensive lazy loading of code and data. Slight differences from page to page can produce huge differences in memory usage. Check memory usage for each type of page and view. The administration pages should produce the worst cases.

Warning messages will be shown if the PHP configuration does not meet these requirements. However, while these values may be sufficient for a default Drupal installation, a production site with a number of commonly used modules enabled (CCK, Views etc.) could require 64 MB or more. Typically 128 MB or 256 MB are found in production systems. Some installations may require much more, especially with media-rich implementations. If you are using a hosting service it is important to verify that your host can provide sufficient memory for the set of modules you are deploying or may deploy in the future. (See the Increase PHP memory limit page in the Troubleshooting FAQ for additional information on modifying the PHP memory limit.)


Database extensions

The PHP extension for connecting to your chosen database must be installed and enabled. Drupal's currently supported database connectors are: mysql (the original MySQL extension), mysqli (an improved connector for newer MySQL installations), and pgsql (for PostgreSQL). Note: PHP 5.x no longer enables the mysql extension by default. Please read the links above for installing and enabling your chosen connector. Additionally, Drupal 6.x does not provide the option to select the mysql connector if mysqli is enabled in your PHP configuration.

XML extension

PHP XML extension (for Blog API, Drupal, and Ping modules). This extension is enabled by default in a standard PHP installation; the Windows version of PHP has built-in support for this extension. Enabling the XML extension also enables PHP DOM. DOM is now a systems requirement.

Image library

An image library for PHP such as the GD library is needed for image manipulation (resizing user pictures, image and imagecache modules). GD is included with PHP 4.3 and higher and usually enabled by default. GD is a required extension in Drupal 7 and later. ImageMagick is also supported for basic image manipulations in Drupal core but there is much less support from contributed modules.
If you have administrator rights on a Debian/Ubuntu server, and GD is not already available (see your phpinfo) it can usually be installed by running the following command:
sudo apt-get install php5-gd
or on Redhat/Centos:
sudo yum install php-gd
See the ImageMagick install instructions for your platform if you want that.


Drupal 7 and 8 require PHP compiled with JSON. JSON support is normally compiled as part of PHP core, but in case you're getting errors like PHP Fatal error:  Call to undefined function Drupal\\Component\\Serialization\\json_encode() in ... core/lib/Drupal/Component/Serialization/Json.php try adding the JSON extension.

FileInfo extension

Drupal 8 requires PHP FileInfo extension. This extension is enabled by default; Windows users must include the bundled php_fileinfo.dll DLL file in php.ini to enable this extension.


Recent versions of APC (apparently since 3.1.6) set 'Enable internal debugging in APC' as the default. This generates large numbers of PHP messages that can make diagnosing other problems more difficult. This option can be disabled during installation by explicitly entering no to the prompt - hitting 'enter' will enable the option in spite of the wording of the prompt.

Also see Drupal 7-specific information relating to APC.


.htaccess settings

Some of the memory settings are contained in the default .htaccess file that ships with Drupal, so you shouldn't need to set them explicitly. Note, however, that setting PHP configuration options from .htaccess only works under the following conditions:

  • With Apache (or a compatible web server)
  • If the .htaccess file is actually read, i.e. AllowOverride All in the main Apache configuration (usually httpd.conf) is enabled
  • If PHP is installed as an Apache module

In some shared hosting environments, access to these settings is restricted. If you cannot make these changes yourself, please ask your hosting provider to adjust them for you.

Other interfaces

See the PHP manual for how to change configuration settings for other interfaces to PHP.


If using xdebug:

Setting: xdebug.show_exception_trace = 0
Reason: Could cause Drupal's installer to crash

If using xdebug with Drupal 8:

Setting: xdebug.collect_params = ?
Reason: Setting xdebug.collect_params too high will prevent Drupal 8 from installing and working properly.

Setting: xdebug.max_nesting_level = 256
Reason: Using the default max_nesting_level of 100 (in xdebug versions < 2.3) causes some pages to crash.

Drupal specific version notes on PHP requirements

All versions

On Debian libapache2-mod-php5filter may get installed in preference to libapache2-mod-php5 ( Unfortunately the libapache2-mod-php5filter package has a bug which breaks Drupal -

So, make sure you specify to use the libapache2-mod-php5 package instead.

PHP version Drupal 6 Drupal 7 Drupal 8
4.4 yes, no support no no
5.0 yes no no
5.2 yes 5.2.5+ no
5.3 core ok, modules with warnings yes no
5.4 core ok, modules may fail yes (minimum recommended) 5.4.5+
5.5 no yes yes
5.6 no ?? yes
7 no ?? in progress

Drupal 8

Drupal 8 requires version PHP 5.4.5 or later, with the CURL extension.

Debian currently ships with 5.4.4 and produces an obscure error. For Debian, the minimum patch level is 5.4.4-14. There is an issue open,, to make the minimum requirement 5.4.5.

If your curl library is version 7.35 (the default on some ubuntu distibutions), there is a bug that could intermittently affect connectivity with other sites.

Drupal 8 also works with PHP 5.5.

Drupal 8 can no longer be installed on hosts with the 'magic_quotes_gpc', 'magic_quotes_runtime', or 'safe_mode' PHP ini settings turned on; these settings are deprecated in PHP 5.3 and have no effect anymore in PHP 5.4.

PHP 5.4 is required, for RHEL, we recommend and for Debian, .

If using the APC opcode cache with Drupal 8, APC 3.1.13 or greater is required. PHP 5.5 has the Zend opcode cache built in.

php5-ctype is required.

The following PHP requirements list is from Drupal 8 beta 1.

= array(

Drupal 7

  • The standard PHP extensions (enabled by default) Hash and JSON are required by Drupal 7.
  • Drupal 7 Update manager can install/update modules and themes via SSH if the required libraries have been installed on the server. If you have administrator rights on a Debian/Ubuntu server, and SSH is not already available (see your phpinfo) it can usually be installed by executing:
    apt-get install libssh2-php.
  • PHP Data Objects (PDO) must be activated for Drupal 7 to install and run correctly. Look in your php.ini. Uncomment (remove the leading semicolon) at line extension=php_pdo.dll, extension=php_pdo_mysql.dll. In Linux, these would be and Some Linux distributions may have these extensions by default in files found in the conf.d folder (Ubuntu 12.04: /etc/php5/conf.d has pdo.ini and pdo_mysql.ini). If these lines are not there, you will need to add them. The PECL version of PDO is not compatible with Drupal 7 and cannot be used.
  • Drupal 7 may require the time parameter (max_execution_time) to be at least 30 seconds.
  • Opcode caching may prevent Drupal 7 from completing the install of all database tables, often referred to as the '31 Tables' problem (reported in Drupal 7 Install Problems). PHP 5.5's built-in opcode cache can be disabled through sudo php5dismod opcache followed by a restart of Apache. Once the install is complete, the opcode cache can be re-enabled with sudo php5enmod opcache, again followed by a restart of Apache.
  • APC installation guides sometimes recommend setting apc.include_once_override=1. Although this setting does not appear to affect Drupal 6, it causes Drupal 7 to fail (white screen, error 500) as reported in Do not enable apc.include_once_override.

Drupal 7: PHP 5.2.5 * (5.4 or higher recommended).

*For Drupal 7, versions of PHP 5.2.4 that include backported security patches also meet the requirements. The PHP version included with Ubuntu 8.04 is the most common example of this.

See the phpinfo() page on to learn how to use phpinfo to get the details of your system. For example, phpinfo will tell you if you have a database already installed and what versions of PHP, MySQL, etc. your system is running. Phpinfo will also tell you what PHP variables are set as well as many other helpful things.

Drupal 6

Drupal 6 is currently supported on PHP 4.4+, however we announced dropping PHP 4.x support altogether on March 1st, 2014.

Although PHP 5.3 is supported by Drupal 6, some contributed modules may not be compatible with PHP 5.3, and some PHP 5.3 configurations still show warnings with Drupal 6.14. Work is ongoing to resolve the latter in #360605: PHP 5.3 Compatibility. Most Drupal 6 contributed modules throw E_STRICT errors on PHP 5.3 and many are practically unusuable on 5.4.

Looking for support? Visit the forums, or join #drupal-support in IRC.


ryoken’s picture

It would be helpful (especially those planning to run Drupal on a virtual or dedicated server), to have a comprehensive list/table of required (and optional) PHP extensions. Default PHP extensions (that are automatically enabled) can differ between different operating systems and different PHP versions.

For example, Zend Framework's PHP requirements page is clear and concise, breaking down each PHP extension with a dependency description:

Therefore, those planning to run Drupal on their system can do a quick "php -m" to determine if there are any gaps to meet Drupal's PHP requirements.

tinaunglin’s picture

In this documentation [ or guide ] , the links to the recommending php.ini settings are broken. They don't work anymore and show 404 error.


I am a Web Developer . I love Drupal and its community.

amedjones’s picture

we can still run drupal 8 on php 5.3 ?

If not what is it that php 5.4 offers that php 5.3 doesn't ?

i want to be Drupal when I grow up

tz_earl’s picture

One new php feature that is required is "traits".

Traits are documented at:

A search through the Drupal 8 core files shows several trait definitions.

mbrett5062’s picture

It seems Drupal 8 now requires the following extension enabled also.


I never got this requirement error before Drupal 8 Alpha 14

Editing the page information for Drupal 8 now.

heters’s picture

It's right , Drupal 8 Alpha 14 require the php_fileinfo extension, thank you!!

AFowle’s picture

In openSuse 13.1, D8.0.0-alpha14 installation fails with WSOD without this. The minimum requirements to prevent WSOD are

php5-ctype (added to main text)
php5-json (get nasty text interface rather than WSOD without it)

Probably need more than this at later stages.

AFowle’s picture

These are listed as required by the requirements checking page. These are mentioned in the main text, but not very clearly. I have NOT adjusted page as I don't understand the current entries.

peterx’s picture

The PHP requirements list in Drupal 8 alpha 15:
$required_extensions = array(

AndrzejG’s picture

All above extensions I have in PHP 5.2.17, and my D7 sites are running well on this PHP version. Does it mean that only upgrading of core PHP i required? If yes, is it possible to upgrade PHP within subdirectory in which my Drupal 8 would run?
I'm asking since my host provides Drupal 7 installation in subdirectory on the shared server.

AndrzejG’s picture

OK, I found solution (through location:).

hatranpro’s picture

--UPDATE 11/24/2014 5:35 PM
problem solved

I'm running Windows 7 and IIS 7.5 with PHP 5.4.7
I'm trying to install Drupal 8.0.0 beta3, but I'm stuck with "fileinfo" extension problem, the file in "ext" folder and enabled in php.ini.
is there any solution or I'm running an older PHP version ?