Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 191994 - dev-lang/php incorrect instructions with apache-2.2.x
Summary: dev-lang/php incorrect instructions with apache-2.2.x
Status: VERIFIED INVALID
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: AMD64 Linux
: High normal (vote)
Assignee: Gentoo Linux bug wranglers
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2007-09-10 16:41 UTC by Drake Donahue
Modified: 2007-09-10 19:20 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Drake Donahue 2007-09-10 16:41:57 UTC
Apache 2.2.x httpd.conf does not contain APACHE2_OPTS

 Suggested modified ebuild instructions:

"
 * 
 * To enable php in Apache 2.0.x, you need to edit your /etc/conf.d/apache2 file and
 * add '-D PHP5' to APACHE2_OPTS.
 * 
 * 
 * Configuration file installed as
 *     /etc/apache2/modules.d/70_mod_php5.conf
 * You may want to edit it before turning the module on in /etc/conf.d/apache2
 * 
Apache conf.d file updated.  For this change to take effect, you
must restart the Apache webserver using this command:


/etc/init.d/apache2 restart

 * To enable php in Apache 2.2.x, php must have been compiled with the apache2 USE
 * flag. If php was compiled with the apache2 USE flag, the Apache 2.2 configuration
 * should have been modified and no further configuration is required.
 
For this change to take effect, you
must restart the Apache webserver using this command:

/etc/init.d/apache2 restart

 * 
 * If you have additional third party PHP extensions (such as
 * dev-php5/phpdbg) you may need to recompile them now.
 * A new way of enabling/disabling PHP extensions was introduced
 * with the newer PHP packages releases, so please reemerge any
 * PHP extensions you have installed to automatically adapt to
 * the new configuration layout.
 * 
 * The 'pic' USE flag was added to newer releases of dev-lang/php.
 * With PIC enabled, your PHP installation may become slower, but
 * PIC is required on Hardened-Gentoo platforms (where the USE flag
 * is enabled automatically). You may also need this on other
 * configurations where TEXTRELs are disabled, for example when using
 * certain PaX options in the kernel.
 * 
 * With PHP 5.2, some extensions were removed from PHP because
 * they were unmaintained or moved to PECL. Our ebuilds reflect
 * this: the Filepro and HwAPI (Hyperwave-API) extensions were
 * removed altogether and have no available substitute.
 * The Informix extension was also removed, as well as the optional
 * memory-limit setting: memory-limit is now always enforced!
 * The 'vm-goto' and 'vm-switch' USE flags were also removed,
 * since the alternative VMs aren't really supported upstream
 * and were found to behave badly with PHP 5.2. Once their
 * state becomes clearer, we'll consider readding the USE flags.
 * The Ming extension was removed from our PHP 5.2 ebuild, because
 * there were serious problems with compilation and the required
 * Ming library. This functionality will be reintroduced later
 * as an independant, external PHP extension.
 * The configure option --enable-gd-native-ttf (enabled by the
 * 'truetype' USE flag) was removed at upstreams request,
 * as it's considered old and broken.
 * Hardened-PHP was also removed from the PHP 5.2 ebuilds in
 * favour of its successor Suhosin, enable the 'suhosin' USE
 * flag to install it.
 * 
 * The 'xml' and 'xml2' USE flags were unified in only the 'xml' USE
 * flag. To get the features that were once controlled by the 'xml2'
 * USE flag, turn the 'xml' USE flag on.
 * 
"
 


Reproducible: Always

Steps to Reproduce:
1.emerge php
2.read end of output
3.

Actual Results:  
Got end of build instructions that did not reflect that Apache 2.2.x configuration was different from Apache 2.0.x.

Quoting current ebuild instructions:

 "
 *
 * To enable php, you need to edit your /etc/conf.d/apache2 file and
 * add '-D PHP5' to APACHE2_OPTS.
 * 
 * 
 * Configuration file installed as
 *     /etc/apache2/modules.d/70_mod_php5.conf
 * You may want to edit it before turning the module on in /etc/conf.d/apache2
 * 
Apache conf.d file updated.  For this change to take effect, you
must restart the Apache webserver using this command:

/etc/init.d/apache2 restart
 * 
 * If you have additional third party PHP extensions (such as
 * dev-php5/phpdbg) you may need to recompile them now.
 * A new way of enabling/disabling PHP extensions was introduced
 * with the newer PHP packages releases, so please reemerge any
 * PHP extensions you have installed to automatically adapt to
 * the new configuration layout.
 * 
 * The 'pic' USE flag was added to newer releases of dev-lang/php.
 * With PIC enabled, your PHP installation may become slower, but
 * PIC is required on Hardened-Gentoo platforms (where the USE flag
 * is enabled automatically). You may also need this on other
 * configurations where TEXTRELs are disabled, for example when using
 * certain PaX options in the kernel.
 * 
 * With PHP 5.2, some extensions were removed from PHP because
 * they were unmaintained or moved to PECL. Our ebuilds reflect
 * this: the Filepro and HwAPI (Hyperwave-API) extensions were
 * removed altogether and have no available substitute.
 * The Informix extension was also removed, as well as the optional
 * memory-limit setting: memory-limit is now always enforced!
 * The 'vm-goto' and 'vm-switch' USE flags were also removed,
 * since the alternative VMs aren't really supported upstream
 * and were found to behave badly with PHP 5.2. Once their
 * state becomes clearer, we'll consider readding the USE flags.
 * The Ming extension was removed from our PHP 5.2 ebuild, because
 * there were serious problems with compilation and the required
 * Ming library. This functionality will be reintroduced later
 * as an independant, external PHP extension.
 * The configure option --enable-gd-native-ttf (enabled by the
 * 'truetype' USE flag) was removed at upstreams request,
 * as it's considered old and broken.
 * Hardened-PHP was also removed from the PHP 5.2 ebuilds in
 * favour of its successor Suhosin, enable the 'suhosin' USE
 * flag to install it.
 * 
 * The 'xml' and 'xml2' USE flags were unified in only the 'xml' USE
 * flag. To get the features that were once controlled by the 'xml2'
 * USE flag, turn the 'xml' USE flag on.
 * 
"

Expected Results:  
Provide instructions for both forks.

Got into this via emerge -unD world. Presumably I updated Apache2.0.x to 2.2.x  after updating php5 and/or tried to keep my original Apache 2.0.x httpd.conf in etc-update. Otherwise it appears the updates would have gone in transparently, I would have never noticed the loss of php in Apache, and never have gotten into a few hours of troubleshooting that included a single action emerge of Apache followed by a single action emerge of php5, followed by reading the familiar and outdated instructions.
Comment 1 Jakub Moc (RETIRED) gentoo-dev 2007-09-10 19:00:42 UTC
(In reply to comment #0)
> Apache 2.2.x httpd.conf does not contain APACHE2_OPTS

Except that it talks about /etc/conf.d/apache2