-
Notifications
You must be signed in to change notification settings - Fork 865
Move/rewrite some of the macOS and Unix install instructions #3763
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
jimwins
merged 21 commits into
php:master
from
jimwins:clean-up-installation-instructions
Sep 24, 2024
Merged
Changes from 10 commits
Commits
Show all changes
21 commits
Select commit
Hold shift + click to select a range
4b64735
Move/rewrite some of the macOS and Unix install instructions
jimwins ec6dae0
Make it clear that Debian also includes it's derivatives
jimwins aa77c34
Better title for this section
jimwins f156124
Add section about installing on DNF-based systems
jimwins d7b735a
Fix trailing whitespace
jimwins 019fd8e
Fix `<literal>` that should be `<command>` in several places
jimwins e074a07
Remove lower-cased "linux" mention
jimwins ad673c4
Turn warning into an entity, will probably be using it more
jimwins e76aa6f
Retitle and bump up the OpenBSD instructions
jimwins 907d8d8
Add note about C compiler, remove automake and libtool
jimwins 11016ba
Eliminate repetition of 'apt or aptitude'
jimwins 6bbca87
Fix indentation
jimwins f2e5127
Rework example for packages that actually exist (in CentOS)
jimwins 22e3250
Remove blank line
jimwins a19cbfe
Fix whitespace
jimwins 2312fd6
Fix formatting and add some links
jimwins b73afa5
Remove unnecessary `<para>` around lists, change a list to `<simpleli…
jimwins 757f931
Clean up whitespace and markup
jimwins 60a6fd4
Fix markup and whitespace
jimwins 3200e02
Fix markup, whitespace, and some personalization in old text
jimwins 917d399
Add links for prerequisites
jimwins File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,113 @@ | ||
| <?xml version="1.0" encoding="utf-8"?> | ||
| <!-- $Revision$ --> | ||
| <sect1 xml:id="install.unix.dnf" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> | ||
| <title>Installing from packages on GNU/Linux distributions that use DNF</title> | ||
| <para> | ||
| While PHP can be installed from source, it is also available through | ||
| packages on systems that use DNF, such as Red Hat Enterprise Linux, | ||
| OpenSUSE, Fedora, CentOS, Rocky Linux, and Oracle Enterprise Linux. | ||
| </para> | ||
|
jimwins marked this conversation as resolved.
Outdated
|
||
| &warn.install.third-party-support; | ||
| <para> | ||
| The packages can be installed using the <command>dnf</command> command. | ||
| </para> | ||
|
jimwins marked this conversation as resolved.
Outdated
|
||
| <sect2 xml:id="install.unix.dnf.packages"> | ||
| <title>Installing packages</title> | ||
| <simpara> | ||
| First, note that other related packages may be desired like | ||
|
jimwins marked this conversation as resolved.
Outdated
|
||
| <literal>php-pear</literal> for PEAR, or <literal>php-mysqlnd</literal> | ||
| for the MySQL extension. | ||
|
jimwins marked this conversation as resolved.
Outdated
|
||
| </simpara> | ||
| <simpara> | ||
| Second, before installing a package, it's wise to ensure the package list | ||
| is up to date. Typically, this is done by running the command | ||
| <command>dnf update</command>. | ||
| </simpara> | ||
| <example xml:id="install.unix.dnf.example"> | ||
| <title>DNF Install Example</title> | ||
| <programlisting role="shell"> | ||
| <![CDATA[ | ||
| # dnf install php php-common | ||
| ]]> | ||
| </programlisting> | ||
| </example> | ||
| <simpara> | ||
| DNF will automatically install the configuration for PHP for the web server, | ||
| but it may need to be restarted in order for the changes to take effect. | ||
| For example: | ||
| </simpara> | ||
| <example xml:id="install.unix.dnf.example2"> | ||
| <title>Restarting Apache once PHP is installed</title> | ||
| <programlisting role="shell"> | ||
| <![CDATA[ | ||
| # sudo systemctl restart httpd | ||
| ]]> | ||
| </programlisting> | ||
| </example> | ||
| </sect2> | ||
| <sect2 xml:id="install.unix.dnf.config"> | ||
| <title>Better control of configuration</title> | ||
| <simpara> | ||
| In the last section, PHP was installed with only core modules. It's | ||
| very likely that additional modules will be desired, such as | ||
| <link linkend="book.mysql">MySQL</link>, | ||
| <link linkend="book.curl">cURL</link>, | ||
| <link linkend="book.image">GD</link>, | ||
| etc. These may also be installed via the <command>dnf</command> command. | ||
| </simpara> | ||
|
jimwins marked this conversation as resolved.
Outdated
|
||
| <example xml:id="install.unix.dnf.config.example"> | ||
| <title>Methods for listing additional PHP packages</title> | ||
| <programlisting role="shell"> | ||
| <![CDATA[ | ||
| # dnf search php | ||
| ]]> | ||
| </programlisting> | ||
| </example> | ||
| <simpara> | ||
| The examples will show a lot of packages including several PHP specific ones | ||
| like php-cgi, php-cli and php-dev. Determine which are needed | ||
|
jimwins marked this conversation as resolved.
Outdated
|
||
| and install them like any other with <command>dnf</command>. | ||
| Because the package manager does | ||
| dependency checks, it'll prompt for those. For example, to install | ||
|
jimwins marked this conversation as resolved.
Outdated
|
||
| MySQL and cURL: | ||
| </simpara> | ||
| <example xml:id="install.unix.dnf.config.example2"> | ||
| <title>Install PHP with MySQL, cURL</title> | ||
| <programlisting role="shell"> | ||
| <![CDATA[ | ||
| # dnf install php-mysqlnd php-curl | ||
| ]]> | ||
| </programlisting> | ||
| </example> | ||
| <simpara> | ||
|
jimwins marked this conversation as resolved.
Outdated
|
||
| DNF will automatically add the appropriate lines to the | ||
| different &php.ini; related files like | ||
| <filename>/etc/php/8.3/php.ini</filename>, | ||
| <filename>/etc/php/8.3/conf.d/*.ini</filename>, etc. and depending on | ||
| the extension will add entries similar to <literal>extension=foo.so</literal>. | ||
| However, restarting the web server (like Apache) is required before these | ||
| changes take affect. | ||
| </simpara> | ||
| </sect2> | ||
|
jimwins marked this conversation as resolved.
|
||
| </sect1> | ||
|
|
||
| <!-- Keep this comment at the end of the file | ||
| Local variables: | ||
|
jimwins marked this conversation as resolved.
|
||
| mode: sgml | ||
| sgml-omittag:t | ||
| sgml-shorttag:t | ||
| sgml-minimize-attributes:nil | ||
| sgml-always-quote-attributes:t | ||
| sgml-indent-step:1 | ||
| sgml-indent-data:t | ||
| indent-tabs-mode:nil | ||
| sgml-parent-document:nil | ||
| sgml-default-dtd-file:"~/.phpdoc/manual.ced" | ||
| sgml-exposed-tags:nil | ||
| sgml-local-catalogs:nil | ||
| sgml-local-ecat-files:nil | ||
| End: | ||
| vim600: syn=xml fen fdm=syntax fdl=2 si | ||
| vim: et tw=78 syn=sgml | ||
| vi: ts=1 sw=1 | ||
| --> | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.