%general-entities; ]> $LastChangedBy$ $Date$ PHP-&php-version; PHP Introduction to PHP PHP is the PHP Hypertext Preprocessor. Primarily used in dynamic web sites, it allows for programming code to be directly embedded into the HTML markup. It is also useful as a general purpose scripting language. &lfs77_checked; &gcc5_checked; Package Information Download (HTTP): Download (FTP): Download MD5 sum: &php-md5sum; Download size: &php-size; Estimated disk space required: &php-buildsize; Estimated build time: &php-time; Additional Downloads Pre-built documentation (optional): PHP Dependencies Recommended and Optional System Utilities and Libraries , , , , , an (that provides a sendmail command) OSSP mm, Net-SNMP, re2c, XMLRPC-EPI, and Dmalloc Optional Graphics Utilities and Libraries , , , , , , ClibPDF, GD, t1lib, and FDF Toolkit Optional Web Utilities , , mnoGoSearch, Hyperwave, Roxen WebServer, Caudium, and WDDX Optional Data Management Utilities and Libraries , , or MySQL, , , , QDBM, cdb, Mini SQL, Empress, Birdstep, DBMaker, Adabas, FrontBase, and Monetra PHP also provides support for many commercial database tools such as Oracle, SAP and ODBC Router. Optional Security/Encryption Utilities and Libraries , , , libmcrypt, and mhash User Notes: Installation of PHP You can use PHP for server-side scripting, command-line scripting or client-side GUI applications. This book provides instructions for setting up PHP for server-side scripting as it is the most common form. PHP has many more configure options that will enable support for various things. You can use ./configure --help to see a full list of the available options. Also, use of the PHP web site is highly recommended, as their online docs are very good. An example of a configure command that utilizes many of the most common dependencies can be found at . If, for whatever reason, you don't have installed, you need to add to the configure command in the instructions below. Note that this will prevent the pear command from being built. Install PHP by running the following commands: ./configure --prefix=/usr \ --sysconfdir=/etc \ --localstatedir=/var \ --datadir=/usr/share/php \ --mandir=/usr/share/man \ --enable-fpm \ --with-fpm-user=apache \ --with-fpm-group=apache \ --with-config-file-path=/etc \ --with-zlib \ --enable-bcmath \ --with-bz2 \ --enable-calendar \ --enable-dba=shared \ --with-gdbm \ --with-gmp \ --enable-ftp \ --with-gettext \ --enable-mbstring \ --with-readline && make To test the results, issue: make test. A few tests may fail, in which case you are asked whether you want to send the report to the PHP developpers. If you want to automate the test, you may prefix the command with yes "n" | . Now, as the root user: make install && install -v -m644 php.ini-production /etc/php.ini && mv -v /etc/php-fpm.conf{.default,} && install -v -m755 -d /usr/share/doc/php-&php-version; && install -v -m644 CODING_STANDARDS EXTENSIONS INSTALL NEWS README* UPGRADING* php.gif \ /usr/share/doc/php-&php-version; && ln -v -sfn /usr/lib/php/doc/Archive_Tar/docs/Archive_Tar.txt \ /usr/share/doc/php-&php-version; && ln -v -sfn /usr/lib/php/doc/Structures_Graph/docs \ /usr/share/doc/php-&php-version; The pre-built HTML documentation is packaged in two forms: a tarball containing many individual files, useful for quick loading into your browser, and one large individual file, which is useful for using the search utility of your browser. If you downloaded either, or both, of the documentation files, issue the following commands as the root user to install them (note these instructions assume English docs, modify the tarball names below if necessary). For the Single HTML file: install -v -m644 ../php_manual_en.html.gz \ /usr/share/doc/php-&php-version; && gunzip -v /usr/share/doc/php-&php-version;/php_manual_en.html.gz For the Many HTML files tarball: tar -xvf ../php_manual_en.tar.gz \ -C /usr/share/doc/php-&php-version; --no-same-owner Command Explanations --with-datadir=/usr/share/php: This works around a bug in the build machinery, which installs some data to a wrong location. --enable-fpm: This parameter allows building the fastCGI Process Manager. --with-config-file-path=/etc: This parameter makes PHP look for the php.ini configuration file in /etc. --with-zlib: This parameter adds support for Zlib compression. --enable-bcmath: Enables bc style precision math functions. --with-bz2: Adds support for Bzip2 compression functions. --enable-calendar: This parameter provides support for calendar conversion. --enable-dba=shared: This parameter enables support for database (dbm-style) abstraction layer functions. --enable-ftp: This parameter enables FTP functions. --with-gettext: Enables functions that use Gettext text translation. --enable-mbstring: This parameter enables multibyte string support. --with-readline: This parameter enables command line Readline support. : This option includes MariaDB/MySQL support. : This option allows building PHP without libxml2 installed. : Instead of building the fastCGI process manager, it is possible to build an apache module. This has some performance penalty for heavy loaded servers, but may be easier to set up. This switch is incompatible with the --enable-fpm and --with-fpm-... switches. Configuring PHP Config Files /etc/php.ini, /etc/pear.conf, and /etc/php-fpm.conf /etc/php.ini /etc/pear.conf /etc/php-fpm.conf Configuration Information The file used as the default /etc/php.ini configuration file is recommended by the PHP development team. This file modifies the default behavior of PHP. If no /etc/php.ini is used, all configuration settings fall to the defaults. You should review the comments in this file and ensure the changes are acceptable in your particular environment. You may have noticed the following from the output of the make install command: You may want to add: /usr/lib/php to your php.ini include_path If desired, add the entry using the following command as the root user: sed -i 's@php/includes"@&\ninclude_path = ".:/usr/lib/php"@' \ /etc/php.ini To enable fastCGI support in the Apache web server, two LoadModule directives must be added to the httpd.conf file. They are commented out, so just issue the following command as root user: sed -i -e '/proxy_module/s/^#//' \ -e '/proxy_fcgi_module/s/^#//' \ /etc/httpd/httpd.conf Those modules accept various ProxyPass directives. One possibility is (as the root user): echo \ 'ProxyPassMatch ^/(.*\.php)$ fcgi://127.0.0.1:9000/srv/www/$1' >> \ /etc/httpd/httpd.conf Additionally, it may be useful to add an entry for index.php to the DirectoryIndex directive of the httpd.conf file. Lastly, adding a line to setup the .phps extension to show highlighted PHP source may be desirable: AddType application/x-httpd-php-source .phps You'll need to restart the Apache web server after making any modifications to the httpd.conf file. Boot Script To automatically start the php-fpm daemon when the system is rebooted, install the /etc/rc.d/init.d/php bootscript from the package as the root user: php make install-php Contents Installed Programs Installed Libraries Installed Directories pear, peardev, pecl, phar (symlink), phar.phar, php, php-cgi, php-config, php-fpm, and phpize dba.{so,a} and opcache.{so,a} at /usr/lib/php/extensions/no-debug-non-zts-20131226/ /usr/include/php, /usr/lib/php, /usr/share/php and /usr/share/doc/php-&php-version; Short Descriptions php is a command line interface that enables you to parse and execute PHP code. php pear is the PHP Extension and Application Repository (PEAR) package manager. pear php-fpm is the fastCGI process manager for PHP. php-fpm