mirror of
https://git.FreeBSD.org/ports.git
synced 2025-01-01 05:45:45 +00:00
634d29d414
Quite a few users still depend on this and are getting it from untrusted sources. Its security track record is actually pretty good still. SuPHP is still the simplest solution for shared hosting. Other vendors still provide this as well. - Add a pkg-message explaining the situation and advising users to move away from this if possible. - Stage - Take maintainership
60 lines
2.2 KiB
Plaintext
60 lines
2.2 KiB
Plaintext
----------------------------------------------------------------
|
|
For help on using this module, please see the suPHP homepage:
|
|
|
|
http://www.suphp.org/
|
|
|
|
Using suPHP can break some PHP-scripts, because of Apache's CGI
|
|
interface.
|
|
-----------------------------------------------------------------
|
|
|
|
-----------------------------------------------------------------
|
|
For those migrating from suPHP 0.5.x, be aware there are many
|
|
changes since 0.6.x that can cause your current Apache environment
|
|
to stop working or behave oddly. Here are two migration tips:
|
|
|
|
suPHP now uses a configuration file for runtime configuration.
|
|
The file is located at:
|
|
|
|
/usr/local/etc/suphp.conf
|
|
|
|
...but *has not* been created for you. A sample configuration
|
|
file has been installed here:
|
|
|
|
/usr/local/etc/suphp.conf-example
|
|
|
|
This means that many of the make.conf(5) knobs for the
|
|
www/suphp port are no longer used, and are modifiable in
|
|
real-time; thus, things like WITHOUT_CHECKPATH and SUPHP_PATH
|
|
are no longer needed. Instead, edit the config file.
|
|
|
|
Equally as important, suPHP no longer uses a static MIME type
|
|
for determining what content get handled by suPHP. In 0.5.x,
|
|
you used the following Apache directives:
|
|
|
|
suPHP_Engine on
|
|
AddType application/x-httpd-php .php
|
|
AddHandler x-httpd-php .php
|
|
|
|
Since suPHP 0.6.x, you should use the following:
|
|
|
|
suPHP_Engine on
|
|
AddType application/x-httpd-php .php
|
|
suPHP_AddHandler application/x-httpd-php
|
|
|
|
Otherwise, Apache will begin serving PHP files as downloadable
|
|
content, rather than parse them with the PHP interpreter.
|
|
-----------------------------------------------------------------
|
|
|
|
-----------------------------------------------------------------
|
|
For those versions upgraded from 0.6.x to 0.7.x. There are some
|
|
new features and changes for the configuration file:
|
|
|
|
- Multiple path (with patterns) & variable substitution
|
|
support for docroots
|
|
- Double-quoted strings at section '[handlers]'
|
|
ex. application/x-httpd-php="php:/usr/local/bin/php-cgi"
|
|
|
|
These changes may lead to internal server error if without
|
|
modifications of the configuration file from previous version.
|
|
-----------------------------------------------------------------
|