|Article Time Stamp: 11 May 2008, 16:01:22 GMT+7|
Make Your PHP Code Portable
Make sure your program can run on different PHP setups by distributing a custom environment setup. Explains how to create the config and how to get your current configuration.
Why should I care
People are different and they use different PHP configurations so if you want to run a script on your system you have two choices:
- set your global configuration to something that allows the code to run
- set a configuration specific to the program
If you go for the first one, you're in trouble if you try to run two programs which require completely different setups. So the only choice seems to be the second one.
Well, then how do I do this
There are four different ways to set a PHP configuration option:
- through php.ini
- through httpd.conf
- through a .htaccess file
- directly in PHP code
The first and second ones are only available to the system administrator of a website so you generally have to avoid them. Yes, you may have access to those files but think about the other people that may be using the code - do they have access to those files? Usually not.
The third method - via a .htaccess file is available only on Apache and probably the NCSA httpd, but since Apache is the most popular webserver that is usually not a problem. The other thing that you should know about .htaccess files is that they may be disabled by the webmaster. If this is the case your only chance is to use a globally included PHP file which configures the system.
Setting the options with PHP code is the most portable way to configure a system. The only problem is that the accessible options are fewer than those available to a .htaccess file.
I'll go for a .htaccess file
The syntax for setting an option is:
php_flag name on or off
php_value name value
php_flag register_globals off
php_value arg_separator.output &
The example turns off register_globals and sets the value of arg_separator.output to & which is preferred rather than the default &.
Note: you can also set boolean options with the php_value directive, the string will be converted to boolean before assignment.
For more information about .htaccess file, you can look at Dynamic Configuration Files
I'll go for PHP code
There's only one function for setting an option and it is ini_set() it is also aliased as ini_alter(). There is also a function that restores the original value and it is ini_restore().
How to use these:
Note: in the first call to ini_set() you can also use any type of variable it will be converted to boolean before setting the option.
Very nice but I don't know my configuration
I've got something for you too. This is a script that will detect common settings that may prevent your code from executing properly on a different system.
First we define these common options in two arrays for the different access levels, the first one for options available to both PHP code and .htaccess files, and the second only for .htaccess files. You may need to modify that in case you using a non-default settings for other options too.
The two function display_php_conf() and display_htaccess_conf() print the PHP code and .htaccess directives for your config respectively.
Show me the config
This will just call the functions defined above so you can easily copy and paste it to a file or pipe it if you are using the CGI version of PHP.
Example output from the script
php_value arg_separator.input ;&
php_value arg_separator.output ;
php_flag display_errors on
php_flag display_startup_errors on
php_flag magic_quotes_runtime off
php_value error_reporting 2047
php_value variables_order GPCS
php_value gpc_order GPC
php_flag asp_tags off
php_flag magic_quotes_gpc off
php_value output_buffering 4096
php_flag register_globals off
php_flag short_open_tag off
Some general considerations
The above code didn't mention track_vars even a single time because as of PHP 4.0.3 it is always on. The example output was run on PHP 4.2.1 and ini_get() returns FALSE for track_vars as if it does not even exist. If you have an earlier version of PHP it is recommended to set it to true and disable register_globals for security and performance issues.
If you want to find even more information you can always count on the PHP manual.