Skip to content

Commit

Permalink
Move/rewrite much of the macOS and Unix install instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
leonardolara committed Sep 24, 2024
1 parent e43fe3b commit f50a28e
Show file tree
Hide file tree
Showing 8 changed files with 323 additions and 259 deletions.
12 changes: 6 additions & 6 deletions install/macos/index.xml
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 12081e88fbd683e58a029153afd57f043df9721b Maintainer: ae Status: ready --><!-- CREDITS: royopa,narigone,ae -->
<!-- EN-Revision: 4cb53ecbd763db2db808e90d7eda63afb380e6df Maintainer: ae Status: ready --><!-- CREDITS: royopa,narigone,ae,leonardolara -->
<chapter xml:id="install.macosx" xmlns="http://docbook.org/ns/docbook">
<title>Instalação no macOS</title>
<para>
Essa seção contém notas e dicas específicas para instalação do PHP no macOS X.
O PHP já vem incluído nos macOS entre o macOS X (10.0.0) e o macOS Monterey (12.0.0).
A compilação do PHP no macOS é semelhante à <link linkend="install.unix">instalação em Unix</link>.
</para>
<simpara>
O PHP era incluído no macOS nas versões 10 e 11, mas já não é mais incluído desde
o macOS versão 12 (Monterey). A instalação em versões mais recentes requer o uso de
pacotes de terceiros, ou compilação a partir do código-fonte.
</simpara>
&install.macos.packages;
&install.macos.bundled;
&install.macos.compile;
Expand Down
66 changes: 25 additions & 41 deletions install/macos/packages.xml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ab9c95affa258e0e81157b5528e9b4574c01a06c Maintainer: lhsazevedo Status: ready --><!-- CREDITS: royopa,lhsazevedo -->
<!-- EN-Revision: 4cb53ecbd763db2db808e90d7eda63afb380e6df Maintainer: leonardolara Status: ready --><!-- CREDITS: royopa,lhsazevedo,leonardolara -->
<sect1 xml:id="install.macosx.packages" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Usando Pacotes</title>
<title>Instalação no macOS usando pacotes de terceiros</title>
<simpara>
Existem algumas versões do PHP empacotadas e pré-compiladas para
o macOS. Isso pode ajudar na instalação de uma configuração
Expand All @@ -13,49 +13,33 @@
do PHP com as características que você precisa.
</simpara>
<simpara>
A maneira mais rápida de instalar o php no macOS é com homebrew:
Uma maneira fácil de instalar o PHP no macOS é com o
gerenciador de pacotes <link xlink:href="https://brew.sh/">Homebrew</link>.
</simpara>
<para>
<orderedlist>
<listitem>
<para>
instale o homebrew, seguindo as instruções em <link xlink:href="https://brew.sh/">brew.sh</link>
</para>
</listitem>
<listitem>
<simpara>
brew install php
</simpara>
</listitem>
</orderedlist>
</para>
<orderedlist>
<listitem>
<para>
Instale o homebrew, seguindo as instruções no site da web.
</para>
</listitem>
<listitem>
<simpara>
<command>brew install php</command>
</simpara>
</listitem>
</orderedlist>
<simpara>
Os seguintes recursos alternativos também oferecem pacotes fáceis de instalar e
binários pré-compilados para usar o PHP no Mac OS:
binários pré-compilados para usar o PHP no macOS:
</simpara>
<para>
<itemizedlist>
<listitem>
<simpara>
MacPorts:
<link xlink:href="&url.mac.macports;">&url.mac.macports;</link>
</simpara>
</listitem>
<listitem>
<simpara>
Liip:
<link xlink:href="&url.mac.liip;">&url.mac.liip;</link>
(PHP 5.3 - PHP 7.3; descontinuado)
</simpara>
</listitem>
<listitem>
<simpara>
Fink:
<link xlink:href="&url.mac.fink;">&url.mac.fink;</link>
</simpara>
</listitem>
</itemizedlist>
</para>
<simplelist>
<member>
<link xlink:href="&url.mac.macports;">MacPorts</link>
</member>
<member>
<link xlink:href="&url.mac.fink;">Fink</link>
</member>
</simplelist>
</sect1>

<!-- Keep this comment at the end of the file
Expand Down
48 changes: 17 additions & 31 deletions install/unix/debian.xml
Original file line number Diff line number Diff line change
@@ -1,24 +1,18 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f8682cd86a71640bf8771186d1d40881c7a0295e Maintainer: ae Status: ready --><!-- CREDITS: narigone,ae -->
<!-- EN-Revision: 4cb53ecbd763db2db808e90d7eda63afb380e6df Maintainer: ae Status: ready --><!-- CREDITS: narigone,ae,leonardolara -->
<sect1 xml:id="install.unix.debian" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Notas de Instalação para o Debian GNU/Linux</title>
<title>Instalando a partir de pacotes no Debian GNU/Linux e distribuições relacionadas</title>
<para>
Essa seção contém notas e dicas específicas para a instalação do
PHP no <link xlink:href="&url.debian;">Debian GNU/Linux</link>.
O PHP pode ser instalado a partir do código-fonte, mas também está disponível através de
pacores do <link xlink:href="&url.debian;">Debian GNU/Linux</link>.
Isto também vale para outras distribuições baseadas em Debian, como
Ubuntu, Kali Linux, e Linux Mint.
</para>
<warning>
<para>
Compilações não oficiais de terceiros não são suportadas. Quaisquer bugs
devem ser notificados para o Debian a não ser que possam ser reproduzidos utilizando
as últimas compilações disponíveis na <link xlink:href="&url.php.downloads;">área
de download</link>.
</para>
</warning>
&warn.install.third-party-support;
<para>
As instruções de compilação do PHP no Unix se aplicam ao Debian,
de forma que essa página contém informações específicas opções outras,
como utilizar os comandos <literal>apt</literal> ou <literal>aptitude</literal>.
Essa página utilizará esses dois comandos como opções alternativas.
Os pacotes podem ser instalados usando os comandos <command>apt</command> ou
<command>aptitude</command>. Essa página do manual utilizará esses dois
comandos intercambiavelmente.
</para>
<sect2 xml:id="install.unix.debian.apt">
<title>Usando APT</title>
Expand Down Expand Up @@ -63,7 +57,7 @@
<link linkend="book.mysql">MySQL</link>,
<link linkend="book.curl">cURL</link>,
<link linkend="book.image">GD</link>,
etc. Estes também podem ser instalados pelo comando <literal>apt</literal>.
etc. Estes também podem ser instalados pelo comando <command>apt</command>.
</simpara>
<example xml:id="install.unix.debian.config.example">
<title>Métodos listar pacotes adicionais do PHP</title>
Expand All @@ -76,12 +70,12 @@
</programlisting>
</example>
<simpara>
Os exemplos mostrarão uma grande quantidade de pacotes incluindo vários específicos do PHP,
como php-cgi, php-cli e php-dev. Determine quais serão necessários
e instale como quaisquer outros via os comandos <literal>apt</literal>
ou <literal>aptitude</literal>. Como o Debian verifica as
dependências, ele perguntará sobre elas. Por exemplo, para instalar
MySQL e cURL:
A lista de pacotes mostrará uma grande quantidade de pacotes incluindo
componentes básicos do PHP, como <literal>php-cgi</literal>,
<literal>php-cli</literal> e <literal>php-dev</literal>, assim como
muitas extensões do PHP. Quando extensões estão instaladas, pacotes adicionais
serão instalados automaticamente conforme necessário para satisfazer as dependências
desses pacotes.
</simpara>
<example xml:id="install.unix.debian.config.example2">
<title>Instalando PHP com MySQL e cURL</title>
Expand Down Expand Up @@ -119,14 +113,6 @@
servidor web foi reiniciado após a instalação.
</simpara>
</listitem>
<listitem>
<simpara>
Há dois comandos básicos para instalar pacotes no Debian (e em outras
variantes Linux): <literal>apt</literal> e <literal>aptitude</literal>.
Entretanto explicar as sutis diferenças entre esses dois comandos vai
além do escopo deste manual.
</simpara>
</listitem>
</itemizedlist>
</sect2>
</sect1>
Expand Down
116 changes: 116 additions & 0 deletions install/unix/dnf.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,116 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4cb53ecbd763db2db808e90d7eda63afb380e6df Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<sect1 xml:id="install.unix.dnf" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Instalando a partir de pacotes em distribuições GNU/Linux que usam DNF</title>
<simpara>
Embora o PHP possa ser instalado a partir do código-fonte, ele também está disponível por meio
de pacotes em sistemas que usam DNF, como Red Hat Enterprise Linux, OpenSUSE, Fedora,
CentOS, Rocky Linux e Oracle Enterprise Linux.
</simpara>
&warn.install.third-party-support;
<simpara>
Os pacotes podem ser instalados usando o comando <command>dnf</command>.
</simpara>
<sect2 xml:id="install.unix.dnf.packages">
<title>Instalando pacotes</title>
<simpara>
Primeiro, observe que outros pacotes relacionados podem ser desejados, como
<literal>php-pear</literal> para <link xlink:href="&url.pear;">PEAR</link>,
ou <literal>php-mysqlnd</literal> para a <link linkend="book.mysqlnd">extensão
MySQL</link>.
</simpara>
<simpara>
Segundo, antes de instalar um pacote, é aconselhável garantir que a lista
de pacotes esteja atualizada. Normalmente, isso é feito executando o comando
<command>dnf update</command>.
</simpara>
<example xml:id="install.unix.dnf.example">
<title>Exemplo de instalação DNF</title>
<programlisting role="shell">
<![CDATA[
# dnf install php php-common
]]>
</programlisting>
</example>
<simpara>
O DNF instalará automaticamente a configuração do PHP para o servidor web,
mas pode ser necessário reinicializá-lo para que as alterações tenham efeito.
Por exemplo:
</simpara>
<example xml:id="install.unix.dnf.example2">
<title>Reiniciando o Apache depois que o PHP estiver instalado</title>
<programlisting role="shell">
<![CDATA[
# sudo systemctl restart httpd
]]>
</programlisting>
</example>
</sect2>
<sect2 xml:id="install.unix.dnf.config">
<title>Melhor controle da configuração</title>
<para>
Na última seção, o PHP foi instalado apenas com módulos principais. É
muito provável que módulos adicionais sejam desejados, como
<simplelist type="inline">
<member><link linkend="book.mysql">MySQL</link></member>
<member><link linkend="book.curl">cURL</link></member>
<member><link linkend="book.image">GD</link></member>
<member>etc.</member>
</simplelist>
Eles também podem ser instalados através do comando <command>dnf</command>.
</para>
<example xml:id="install.unix.dnf.config.example">
<title>Métodos para listar pacotes PHP adicionais</title>
<programlisting role="shell">
<![CDATA[
# dnf search php
]]>
</programlisting>
</example>
<simpara>
A lista de pacotes conterá um grande número de pacotes que incluem
componentes básicos do PHP, como <literal>php-cli</literal>,
<literal>php-fpm</literal> e <literal>php-devel</literal>, bem como
muitas extensões PHP. Quando as extensões são instaladas, pacotes adicionais
serão instalados automaticamente conforme necessário para satisfazer as dependências
desses pacotes.
</simpara>
<example xml:id="install.unix.dnf.config.example2">
<title>Instalando PHP com MySQL e GD</title>
<programlisting role="shell">
<![CDATA[
# dnf install php-mysqlnd php-gd
]]>
</programlisting>
</example>
<simpara>
O DNF adicionará automaticamente as linhas apropriadas aos
diferentes arquivos &php.ini; relacionados como
<filename>/etc/php/8.3/php.ini</filename>,
<filename>/etc/php/8.3/conf.d/*.ini</filename> etc., e dependendo da
extensão adicionará entradas semelhantes a <literal>extension=foo.so</literal>.
No entanto, é necessário reiniciar o servidor web (como o Apache) antes que essas
alterações tenham efeito.
</simpara>
</sect2>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
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
-->
Loading

0 comments on commit f50a28e

Please sign in to comment.