php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #6856 Some incorrect information in the INSTALL file of php-4.0.2.tar.gz
Submitted: 2000-09-22 18:39 UTC Modified: 2000-09-26 10:59 UTC
From: chr at abelard dot de Assigned:
Status: Closed Package: Documentation problem
PHP Version: 4.0.2 OS: SuSE Linux 6.4
Private report: No CVE-ID: None
 [2000-09-22 18:39 UTC] chr at abelard dot de
1.) The INSTALL file says (about line 45 ff. and 136 ff.) that one can prove enabling of mod_so from apache by typing
	httpd -l 

That's not quite right, because this output appear even apache was compiled with "--enable-shared=so" only - but in this case mod_so is _not_ enabled (says apache's dokumentation and is my test result)!

To enable mod_so you _must_ configure apache with both:
	"--enable-module=so --enable-shared=so".

(Note: The same mistake appears in documentation of apache in file README.configure. But in the INSTALL file of apache about line 336 ff. you can read in Notes 2,3 and 4 that both parameters for configure are neccessary for DSO-support.
And for me it works only in this way.)


2.) At least unclear is the documentation for the configure parameter "--with-mysql" about lines 189 ff. in INSTALL. Although given for static compilation only I needed it for my DSO installation, too.
What really is needed are not sources from MySQL or a path with a library but a path, from which exists a directory "lib/" or "lib/mysql/" in which reside the MySQL client library "libmysqlclient.so". So since I have "/usr/lib/libmysqlclient.so" I had to use "--with-mysql=/usr" for success.

(Note: The pur "--with-mysql" has given a warning because use of PHP-internal MySQL source, with isn't compatible for use with additionally modules.)


3.) A special note for use of a SuSE apache: There is enabled for apache per default "-D EAPI". PHP will only work with this when configured with "--with-eapi" or when EAPI was disabled for apache.
(I can't find this hint in the PHP documentation anywhere.)


So far.
Greetings
Christian Schmidt-Guetter

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2000-09-26 10:59 UTC] rasmus@php.net
1) You are wrong.  --enable-shared=so makes absolutely no sense as you would need to have mod_so loaded in order to load a shared mod_so.  Chicken and egg problem.  --enable-module=so is sufficient.

2) I suppose it could be clearer in the docs, but it isn't too bad the way it is right now.

3) PHP will ask apxs which flags to use to build PHP.  If you Apache is built with EAPI then your apxs should be specifying this if your Apache is properly installed.
 
PHP Copyright © 2001-2026 The PHP Group
All rights reserved.
Last updated: Tue Jun 16 01:00:01 2026 UTC