|
1 |
| -The PHP Interpreter |
2 |
| -=================== |
| 1 | +<div align="center"> |
| 2 | + <a href="https://php.net"> |
| 3 | + <img |
| 4 | + alt="PHP" |
| 5 | + src="https://static.php.net/www.php.net/images/logos/new-php-logo.svg" |
| 6 | + width="150"> |
| 7 | + </a> |
| 8 | +</div> |
3 | 9 |
|
4 |
| -This is the github mirror of the official PHP repository located at |
5 |
| -https://git.php.net. |
| 10 | +# The PHP Interpreter |
6 | 11 |
|
7 |
| -[](http://travis-ci.org/php/php-src) |
| 12 | +PHP is a popular general-purpose scripting language that is especially suited to |
| 13 | +web development. Fast, flexible and pragmatic, PHP powers everything from your |
| 14 | +blog to the most popular websites in the world. PHP is distributed under the PHP |
| 15 | +License v3.01. |
| 16 | + |
| 17 | +[](https://travis-ci.org/php/php-src) |
8 | 18 | [](https://ci.appveyor.com/project/php/php-src)
|
9 | 19 |
|
10 |
| -Pull Requests |
11 |
| -============= |
12 |
| -PHP accepts pull requests via github. Discussions are done on github, but |
13 |
| -depending on the topic can also be relayed to the official PHP developer |
14 |
| - |
| 20 | +## Documentation |
| 21 | + |
| 22 | +The PHP manual is available at [php.net/docs](https://php.net/docs). |
| 23 | + |
| 24 | +## Installation |
| 25 | + |
| 26 | +### Prebuilt packages and binaries |
| 27 | + |
| 28 | +Prebuilt packages and binaries can be used to get up and running fast with PHP. |
| 29 | + |
| 30 | +For Windows, the PHP binaries can be obtained from |
| 31 | +[windows.php.net](https://windows.php.net). After extracting the archive the |
| 32 | +`*.exe` files are ready to use. |
| 33 | + |
| 34 | +For other systems, see the [installation chapter](https://php.net/install). |
| 35 | + |
| 36 | +### Building PHP from source |
| 37 | + |
| 38 | +On \*nix systems: |
| 39 | + |
| 40 | + ./buildconf |
| 41 | + ./configure |
| 42 | + make |
| 43 | + make test |
| 44 | + sudo make install |
15 | 45 |
|
16 |
| -New features require an RFC and must be accepted by the developers. |
17 |
| -See https://wiki.php.net/rfc and https://wiki.php.net/rfc/voting for more |
18 |
| -information on the process. |
| 46 | +See `./configure -h` and `make -h` for configuration options. For example, the |
| 47 | +`-j` option allows parallel execution of the build recipes where `N` is the |
| 48 | +number of available processor cores: |
19 | 49 |
|
20 |
| -Bug fixes **do not** require an RFC, but require a bugtracker ticket. Always |
21 |
| -open a ticket at https://bugs.php.net and reference the bug id using #NNNNNN. |
| 50 | + make -j N |
| 51 | + |
| 52 | +For Windows, see |
| 53 | +[Build your own PHP on Windows](https://wiki.php.net/internals/windows/stepbystepbuild_sdk_2). |
| 54 | + |
| 55 | +## PHP extensions |
| 56 | + |
| 57 | +Extensions provide additional functionality on top of PHP. PHP consists of many |
| 58 | +essential bundled extensions. Additional extensions can be found in the PHP |
| 59 | +Extension Community Library - [PECL](https://pecl.php.net). |
| 60 | + |
| 61 | +## Contributing |
| 62 | + |
| 63 | +The PHP source code is located in the Git repository at |
| 64 | +[git.php.net](https://git.php.net). Contributions are most welcome by forking |
| 65 | +the [GitHub mirror repository](https://github.com/php/php-src) and sending a |
| 66 | +pull request. |
| 67 | + |
| 68 | +Discussions are done on GitHub, but depending on the topic can also be relayed |
| 69 | +to the official PHP developer mailing list [email protected]. |
| 70 | + |
| 71 | +New features require an RFC and must be accepted by the developers. See |
| 72 | +[Request for comments - RFC](https://wiki.php.net/rfc) and |
| 73 | +[Voting on PHP features](https://wiki.php.net/rfc/voting) for more information |
| 74 | +on the process. |
| 75 | + |
| 76 | +Bug fixes **do not** require an RFC but require a bug tracker ticket. Open a |
| 77 | +ticket at [bugs.php.net](https://bugs.php.net) and reference the bug id using |
| 78 | +`#NNNNNN`. |
22 | 79 |
|
23 | 80 | Fix #55371: get_magic_quotes_gpc() throws deprecation warning
|
24 | 81 |
|
25 |
| - After removing magic quotes, the get_magic_quotes_gpc function caused |
26 |
| - a deprecate warning. get_magic_quotes_gpc can be used to detected |
27 |
| - the magic_quotes behavior and therefore should not raise a warning at any |
28 |
| - time. The patch removes this warning |
| 82 | + After removing magic quotes, the get_magic_quotes_gpc function caused a |
| 83 | + deprecated warning. get_magic_quotes_gpc can be used to detect the |
| 84 | + magic_quotes behavior and therefore should not raise a warning at any time. |
| 85 | + The patch removes this warning. |
29 | 86 |
|
30 |
| -We do not merge pull requests directly on github. All PRs will be |
31 |
| -pulled and pushed through https://git.php.net. |
| 87 | +Pull requests are not merged directly on GitHub. All PRs will be pulled and |
| 88 | +pushed through [git.php.net](https://git.php.net). See |
| 89 | +[Git workflow](https://wiki.php.net/vcs/gitworkflow) for more details. |
32 | 90 |
|
| 91 | +### Guidelines for contributors |
33 | 92 |
|
34 |
| -Guidelines for contributors |
35 |
| -=========================== |
36 |
| -- [CODING_STANDARDS](/CODING_STANDARDS) |
37 |
| -- [README.GIT-RULES](/README.GIT-RULES) |
38 |
| -- [README.MAILINGLIST_RULES](/README.MAILINGLIST_RULES) |
39 |
| -- [README.RELEASE_PROCESS](/README.RELEASE_PROCESS) |
| 93 | +See further documents in the repository for more information on how to |
| 94 | +contribute: |
| 95 | + |
| 96 | +- [Contributing to PHP](/CONTRIBUTING.md) |
| 97 | +- [PHP coding standards](/CODING_STANDARDS) |
| 98 | +- [Git rules](/README.GIT-RULES) |
| 99 | +- [Mailinglist rules](/README.MAILINGLIST_RULES) |
| 100 | +- [PHP release process](/README.RELEASE_PROCESS) |
40 | 101 |
|
41 | 102 | ## Testing
|
42 | 103 |
|
43 |
| -To run tests the `make test` is used after successful compilation of the sources. |
| 104 | +To run tests the `make test` is used after a successful compilation of the |
| 105 | +sources. The `-j` option provides faster parallel execution based on the number |
| 106 | +of cores (`N`): |
| 107 | + |
| 108 | + make -j N test |
44 | 109 |
|
45 |
| -See [Creating new test files](https://qa.php.net/write-test.php) chapter for more |
46 |
| -information about testing. |
| 110 | +The [qa.php.net](https://qa.php.net) site provides more detailed info about |
| 111 | +testing and quality assurance. |
0 commit comments