Last updated: Sat, 24 Mar 2007

Příloha G. Konfigurační volby

Obsah

Seznam základních konfiguračních voleb

Seznam základních konfiguračních voleb

Níže je částečný seznam konfiguračních voleb používaný skipt configure při kompilaci PHP v unixovských prostředích. Většina konfiguračních voleb je uvedena na příslušných místech na referenčních stránkách jednotlivých rozšíření, nikoli zde. Pro úplný aktuální seznam konfiguračních voleb spusťte ve svém adresáři se zdrojovými kódy PHP příkaz ./configure --help poté, co jste spustili autoconf (viz také Instalační kapitolu). Může pro vás být také zajímavé přečíst si dokumentaci » GNU configure, kde najdete informace od dalších volbách configure, jako je --prefix=PREFIX.

Poznámka: Tyto volby se používají pouze při kompilaci. Chcete-li změnit provozní konfiguraci PHP, přečtěte si prosím kapitolu o Provozní konfiguraci.

Konfigurační volby PHP 4

Poznámka: Tyto volby se používají pouze v PHP 4 od PHP 4.1.0. Některé jsou k dispozici ve starších verzích PHP 4, některé i v PHP3, některé jen v PHP 4.1.0. Chcete-li kompilovat starší verzi, některé volby pravděpodobně nebudou dostupné.

Různé volby

--enable-debug: Kompiluje s ladicími symboly.
--with-layout=TYPE: Nastavuje, jak mají být instalované soubory rozloženy. Typ je buď PHP (výchozí) nebo GNU.
--with-pear=DIR: Instaluje PEAR do adresáře DIR (výchozí je PREFIX/lib/php).
--without-pear: Neinstaluje se PEAR.
--enable-sigchild: Zapne vlastní handler PHP pro signál SIGCHLD.
--disable-rpath: Vypne předávání dalších vyhledávacích cest pro knihovny.
--enable-libgcc: Zapne explicitní linkování proti libgcc.
--enable-php-streams: Zahrne experimentální PHP streamy. Nepoužívejte, pokud netestujete kód!
--with-zlib-dir[=DIR]: Určuje umístění instalačního adresáře zlib.
--enable-trans-sid: Zapne transparentní propagaci session id. Platí pouze pro PHP 4.1.2 nebo starší. Od PHP 4.2.0 se trans-sid kompiluje vždy.
--with-tsrm-pthreads: Použije vlákna POSIXu (výchozí).
--enable-shared[=PKGS]: Kompiluje sdílené knihovny [výchozí=yes].
--enable-static[=PKGS]: Kompiluje statické knihovny [výchozí=yes].
--enable-fast-install[=PKGS]: Optimalizuje pro rychlou instalaci [výchozí=yes].
--with-gnu-ld: Stanoví předpoklad, že kompilátor C používá GNU ld [výchozí=no].
--disable-libtool-lock: Zamezí zamykání během kompilace (může poškodit paralelní kompilace).
--with-pic: Pokusí se použít pouze PIC/non-PIC objekty [výchozí=use both].
--enable-memory-limit: Kompiluje se s porporou pro limit paměti.
--disable-url-fopen-wrapper: Vypne wrapper fopen, který rozpoznává URL a umožňuje přistupovat k souborům přes HTTP nebo FTP.
--enable-versioning: Exportuje pouze vyžadované symboly. Pro více informací viz INSTALL.
--with-imsp[=DIR]: Zahrne podporu pro IMSP (DIR je adresář pro include IMSP a soubor libimsp.a). Pouze pro PHP 3!
--with-mck[=DIR]: Zahrne podporu pro Cybercash MCK. DIR je kompilační adresář Cybercash MCK, výchozí je /usr/src/mck-3.2.0.3-linux. Nápovědu najdete v extra/cyberlib. Pouze pro PHP 3!
--with-mod-dav=DIR: Zahrne podporu DAV skrze modul Apache mod_dav. DIR je instalační adresář mod_dav (pouze verze jako modul Apache!). Pouze pro PHP 3!
--enable-debugger: Kompiluje s funkce pro vzdálené ladění. Pouze pro PHP 3!
--enable-versioning: Využívá možností verzování a rozsahů poskytovaných systémy Solaris 2.x a Linux. Pouze pro PHP 3!

Volby PHP

--enable-maintainer-mode: Zapne sestavovací pravidla a závislosti, které nejsou u?ite?né (a jsou ob?as matoucí) pro b??nou instalaci.
--with-config-file-path=PATH: Nastaví cestu, kde se má hledat php.ini, výchozí hodnota je PREFIX/lib.
--enable-safe-mode: Zapne bezpe?ný re?im jako výchozí nastavení.
--with-exec-dir[=DIR]: Povolí pro bezpe?ný re?im pouze programy v adresá?i DIR (výchozí hodnota je /usr/local/php/bin).
--enable-magic-quotes: Zapne "magic quotes" jako výchozí volbu.
--disable-short-tags: Vypne zkrácenou startovací zna?ku <? jako výchozí volbu.

Volby SAPI

Následující seznam obsahuje dostupné SAPI (Server Application Programming Interface) pro PHP.

--with-aolserver=DIR: Specifikuje cestu k instalaci AOLserver.
--with-apxs[=FILE]: Kompiluje sdílený modul Apache. FILE je volitelná cesta k nástroji apxs Apache; výchozí je apxs. Ujistěte se, že specifikujete verzi apxs, která je aktuálně nainstalována na vašem systému a NE tu, která je ve zdrojovém balíku Apache.
--with-apache[=DIR]: Kompiluje statický modul Apache. DIR je nejvyšší adresář kompilace Apache, výchozí je /usr/local/apache.
--with-mod_charset: Zapne přenosové tabulky pro mod_charset (ruský Apache).
--with-apxs2[=FILE]: Kompiluje sdílený modul Apache 2.0. FILE je volitelná cesta k nástroji apxs Apache; výchozí je apxs.
--with-caudium=DIR: Kompiluje PHP jako modul Pike pro použití se serverem Caudium. DIR je adresář serveru Caudium s výchozí hodnotou /usr/local/caudium/server.
--disable-cli: Dostupné v PHP 4.3.0. Vypne kompilaci CLI verze PHP (vynucuje --without-pear). Více informací je k dispozici v sekci o Používání PHP z příkazové řádky.
--enable-embed[=TYPE]: Zapne kompilaci embedded SAPI knihovny. TYPE je buď shared nebo static, přičemž výchozí je shared. Dostupné v PHP 4.3.0.
--with-fhttpd[=DIR]: Kompiluje modul fhttpd. DIR je adresář se zdroji fhttpd, výchozí hodnota je /usr/local/src/fhttpd. Od PHP 4.3.0 již není k dispozici.
--with-isapi=DIR: Kompiluje PHP jak modul ISAPI pro použití se serverem Zeus.
--with-nsapi=DIR: Určuje cestu k instalovanému serveru Netscape/iPlanet/SunONE Webserver.
--with-phttpd=DIR: Zatím bez informací.
--with-pi3web=DIR: Kompiluje PHP jako modul pro použití s Pi3Web.
--with-roxen=DIR: Kompiluje PHP jako modul Pike. DIR je základní adresář Roxen, normálně /usr/local/roxen/server.
--enable-roxen-zts: Kompiluje modul Roxen s použitím Zend Thread Safety.
--with-servlet[=DIR]: Zahrne podporu pro servlet. DIR je základní instalační adresář JSDK. Toto SAPI vyžaduje, aby rozšíření Java bylo kompilováno jako sdílená knihovna.
--with-thttpd=SRCDIR: Kompiluje PHP jako modul thttpd.
--with-tux=MODULEDIR: Kompiluje PHP jako modul pro TUX (pouze Linux).
--with-webjames=SRCDIR: Kompiluje PHP jako modul pro WebJames (pouze RISC OS).
--disable-cgi: Vypne kompilaci CGI verze PHP. Dostupné v PHP 4.3.0.
--enable-force-cgi-redirect: Zapne bezpečnostní kontrolu na vnitřní přesměrování serveru. Měli byste ho používat, pokud spouštíte CGI verzi PHP se serverem Apache.
--enable-discard-path: Pokud je zapnuto, CGI program PHP může být bezpečně umístěn mimo webový strom a uživatelé nebudou schopni obejít zabezpečení .htaccess.
--with-fastcgi: Kompiluje PHP jako aplikaci FastCGI. Od PHP 4.3.0 již není k dispozici, místo toho používejte --enable-fastcgi.
--enable-fastcgi: Je-li zapnuto, CGI modul bude kompilován i s podporou FastCGI. K dispozici od PHP 4.3.0.
--disable-path-info-check: Je-li vypnuto, cesty jako /info.php/test?a=b nebudou fungovat. Dostupné od PHP 4.3.0. Pro více informací viz » Manuál Apache.

Direktivy php.ini

Protokol debuggeru

Last updated: Sat, 24 Mar 2007

add a note User Contributed Notes
Konfigurační volby

Thani
22-Jul-2008 02:35


One of the above mentioned to enable libxml. Instead use disable-all and enable only the required extensions. Otherwise it will complain of libxml for extensions that depend on libxml.

Neil Davis
04-Mar-2008 05:07


If you have compiled php without specifying a --with-config-file-path=PATH

then reconfigure php using --with-config-file-path=PATH, you must do a "make clean" then "make" & "make install" before reinstalling. If you don't make clean first, phpinfo will report the new location set by --with-config-file-path=PATH, but actually be looking for php.ini in the old location.



I'm not sure if this is intended behavior or not but this is a gotcha that got me after compiling, then reconfiguring, then doing make install. It caused a little head scratching.



It's good practice to do make clean after any configuration change anyway. Bite the bullet and take the time to do it right to avoid unexpected module behavior.



-Neil

raj at ap dot krakow dot pl
07-Feb-2008 09:52


It's not stated clearly anywhere in the documentation, but the CGI version won't build if you specify the --with-apxs= option to configure (the CLI version will, however). The only way I found to have *both* Apache module *and* CGI versions of PHP installed was to run configure/make twice - first with --with-apxs= option, to build the Apache module, then without it, to build the CGI binary.

I think if the doc says that the CGI version is built by default, it *should* be built by default, unless you specify --disable-cgi. If --with-apxs= automatically disables CGI, the --disable-cgi option doesn't seem to have any use.

codeslinger at compsalot dot com
30-Nov-2006 10:26


Note: PHP5 has a zillion dependencies on libxml, it is not practical to disable it, you must install it.



libxml can be found here: http://www.xmlsoft.org/



But this is actualy a good thing; "Almost everything regarding XML support was rewritten for PHP 5". 



For more info see: http://www.zend.com/php5/articles/php5-xmlphp.php

jovcic ate gseis stop ucla stop edu
09-Jul-2005 03:26


If you'e compiling a shared extension (e.g. pspell) whose libs & headers are not in the usual place, use the following:



--with-pspell=shared,/my/custom/path/to/pspell/



Took me forever to figure out, since Google had no answer for me.

joerg at fenin dot de
14-Apr-2005 09:15


If some options do not become active after doing a configure; make; make install, try to do a make clean after configure. That worked for me when enabling memory limts (--enable-memory-limit).

17-Jan-2004 12:33


>/usr/local/lib needs to be listed in /etc/ld.so.conf, but it should already

>be there on most systems.  The above notes all apply to Linux only, 

>but may be useful on other platforms as well



 It is much simpler just to put /usr/local/pgsql/lib into /etc/ld.so.conf and then run ldconfig.

steve at njord dot org
06-Oct-2003 02:32


If you're trying to build with --with-imap and your uw-imap stuff is built SSLTYPE=nopwd then you will fail the "Checking if IMAP works" check if you don't also build with --with-imap-ssl



Another hour and a half of my life lost to find that one.



Steve

squeeNoSpam at NoSpamAddress dot com
14-Aug-2002 09:06


[Editor's note: The reason why some general options for the "configure" scripts are not documented is that said script is part of the GNU autoconf tools, and as such its general options are documented elsewhere, e.g.: http://www.gnu.org/manual/autoconf/index.html and http://www.airs.com/ian/configure/. Some are also documented in the INSTALL file that comes with the source distribution.]





The --prefix=PREFIX configure option isn't mentioned here. It apparently defaults to /usr/local, and sets the position of the php includes and libs. (in PREFIX/include/php and PREFIX/lib/php)

tysonlt from web_SPAMOFF_media com au
15-Apr-2002 07:42


RE: Servlet support, I found that you need to configure --with-servlet=/usr/local/tomcat/common.



I found checking the configure script (always a good idea) that it looks for {dir_prefix}/lib/servlet.jar file, and this is found in the tomcat/common directory.



Hope this helps a bit!

ceo at l-i-e dot com
14-Aug-2001 09:05


--enable-sigchild is only relevent to users of Oracle who are having <defunc> processes.

petrov at rice dot edu
03-Nov-2000 07:27


If you are building with --with-pgsql=/some/dir, make sure that you still have libpq loaded up by ldconfig.  I compiled and installed postgres from the tarball and then had to manually create the symlinks in /usr/local/lib.  In particular, after you have built and installed postgres, you need to do the following (presuming you installed to /usr/local/pgsql):





# cd /usr/local/lib


# ln -s ../pgsql/lib/libpq.so.2.1 libpq.so.2.1


# ln -s ../pgsql/lib/libpq.so.2.1 libpq.so.2


# ln -s ../pgsql/lib/libpq.so.2.1 libpq.so


# ldconfig





/usr/local/lib needs to be listed in /etc/ld.so.conf, but it should already be there on most systems.  The above notes all apply to Linux only, but may be useful on other platforms as well.





--sam

add a note

Direktivy php.ini

Protokol debuggeru

Last updated: Sat, 24 Mar 2007