mirror of
https://github.com/php/php-src.git
synced 2026-03-24 16:22:37 +01:00
1c850bfcca
This patch adds missing newlines, trims multiple redundant final newlines into a single one, and trims redundant leading newlines. According to POSIX, a line is a sequence of zero or more non-' <newline>' characters plus a terminating '<newline>' character. [1] Files should normally have at least one final newline character. C89 [2] and later standards [3] mention a final newline: "A source file that is not empty shall end in a new-line character, which shall not be immediately preceded by a backslash character." Although it is not mandatory for all files to have a final newline fixed, a more consistent and homogeneous approach brings less of commit differences issues and a better development experience in certain text editors and IDEs. [1] http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap03.html#tag_03_206 [2] https://port70.net/~nsz/c/c89/c89-draft.html#2.1.1.2 [3] https://port70.net/~nsz/c/c99/n1256.html#5.1.1.2
76 lines
2.3 KiB
Plaintext
76 lines
2.3 KiB
Plaintext
WHAT IS THIS?
|
|
|
|
This module exploits the layered I/O support in Apache 2.0.
|
|
|
|
HOW DOES IT WORK?
|
|
|
|
In Apache 2.0, you have handlers which generate content (like
|
|
reading a script from disk). The content goes then through
|
|
a chain of filters. PHP can be such a filter, so that it processes
|
|
your script and hands the output to the next filter (which will
|
|
usually cause a write to the network).
|
|
|
|
DOES IT WORK?
|
|
|
|
Currently the issues with the module are:
|
|
* Thread safety of external PHP modules
|
|
* The lack of re-entrancy of PHP. due to this I have disabled the 'virtual'
|
|
function, and tried to stop any method where a php script can run another php
|
|
script while it is being run.
|
|
|
|
|
|
HOW TO INSTALL
|
|
|
|
This SAPI module is known to work with Apache 2.0.44.
|
|
|
|
$ cd apache-2.x
|
|
$ cd src
|
|
$ ./configure --enable-so
|
|
$ make install
|
|
|
|
For testing purposes, you might want to use --with-mpm=prefork.
|
|
(Albeit PHP also works with threaded MPMs. See Thread Safety note above)
|
|
|
|
Configure PHP 4:
|
|
|
|
$ cd php-4.x
|
|
$ ./configure --with-apxs2=/path/to/apache-2.0/bin/apxs
|
|
$ make install
|
|
|
|
At the end of conf/httpd.conf, add:
|
|
|
|
AddType application/x-httpd-php .php
|
|
|
|
If you would like to enable source code highlighting functionality add:
|
|
|
|
AddType application/x-httpd-php-source .phps
|
|
|
|
That's it. Now start bin/httpd.
|
|
|
|
HOW TO CONFIGURE
|
|
|
|
The Apache 2.0 PHP module supports a new configuration directive that
|
|
allows an admin to override the php.ini search path. For example,
|
|
place your php.ini file in Apache's ServerRoot/conf directory and
|
|
add this to your httpd.conf file:
|
|
|
|
PHPINIDir "conf"
|
|
|
|
DEBUGGING APACHE AND PHP
|
|
|
|
To debug Apache, we recommend:
|
|
|
|
1. Use the Prefork MPM (Apache 1.3-like process model) by
|
|
configuring Apache with '--with-mpm=prefork'.
|
|
2. Start httpd using -DONE_PROCESS (e.g. (gdb) r -DONE_PROCESS).
|
|
|
|
If you want to debug a part of the PHP startup procedure, set a
|
|
breakpoint on 'load_module'. Step through it until apr_dso_load() is
|
|
done. Then you can set a breakpoint on any PHP-related symbol.
|
|
|
|
TODO
|
|
|
|
PHP functions like apache_sub_req (see php_functions.c)
|
|
Source Code Highlighting
|
|
Protocol handlers
|