Update to En openbsd.xml + infostyle

This commit is contained in:
Mikhail Alferov
2024-09-29 02:37:15 +03:00
committed by GitHub
parent 6871ab5dcf
commit e977a2193d

View File

@ -1,27 +1,27 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 093eb6affefe2ef930b08043a668168d2181ecc1 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 4cb53ecbd763db2db808e90d7eda63afb380e6df Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<sect1 xml:id="install.unix.openbsd" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>OpenBSD, замечания по установке</title>
<title>Установка из пакетов или портов в ОС OpenBSD</title>
<para>
Эта секция содержит замечания и советы, касающиеся установки
PHP на <link xlink:href="&url.openbsd;">OpenBSD</link>.
Cекция содержит замечания и советы, которые касаются установки
PHP на ОС <link xlink:href="&url.openbsd;">OpenBSD</link>.
</para>
<sect2 xml:id="install.unix.openbsd.packages">
<title>Использование бинарных пакетов</title>
<title>Работа с бинарными пакетами</title>
<simpara>
Использование бинарных пакетов для установки PHP на OpenBSD - это простейший
и рекомендованный способ. Ядро (основной пакет) отделено от различных модулей,
но каждый из них может быть установлен или удалён независимо от другого.
Файлы, которые вам понадобятся, вы можете найти на вашем OpenBSD CD или на FTP.
Бинарные пакеты для установки PHP на OpenBSD простейший
и рекомендованный способ. Ядро (основной пакет) отделили от модулей,
но каждый из них устанавливается или удаляется независимо от другого.
Файлы, которые потребуются для установки, доступны на CD-диске с ОС OpenBSD или на FTP-сервере.
</simpara>
<simpara>
Основной пакет, который необходимо установить - это <filename>php</filename>,
он содержит базовый движок (плюс fpm, gettext и iconv) и может быть доступен
в нескольких версиях на выбор. Далее, обратите внимание
на пакеты модулей, такие как <filename>php-mysqli</filename>
или <filename>php-imap</filename>. Вам следует использовать команду
<command>phpxs</command> для активации или деактивации этих модулей в вашем &php.ini;.
Основной пакет, который потребуется установить <filename>php</filename>,
он содержит базовый движок (плюс модули fpm, gettext и iconv) и доступен
в разных версиях на выбор. Затем обратите внимание
на пакеты модулей наподобие <filename>php-mysqli</filename>
или <filename>php-imap</filename>. Включением модулей в файле &php.ini;
управляют командой <command>phpxs</command>.
</simpara>
<example xml:id="install.unix.openbsd.ports.example">
<title>Пример установки пакетов в OpenBSD</title>
@ -33,7 +33,7 @@
(install the PEAR libraries)
# pkg_add pear
Следуйте инструкциям, выводимым пакетами во время установки!
Следуйте инструкциям, которые выводят пакеты во время установки!
(to remove packages)
# pkg_delete php
@ -44,48 +44,52 @@
</programlisting>
</example>
<simpara>
Читайте страницу руководства <link xlink:href="&url.openbsd.packages;">packages(7)</link>
для большей информации о бинарных пакетах в OpenBSD.
Страница руководства к функции <link xlink:href="&url.openbsd.packages;">packages(7)</link>
даёт больше информации о бинарных пакетах в ОС OpenBSD.
</simpara>
</sect2>
<sect2 xml:id="install.unix.openbsd.ports">
<title>Использование портов</title>
<simpara>
Вы можете также скомпилировать PHP из исходников, используя <link xlink:href="&url.openbsd.ports;">дерево портов</link>.
Тем не менее, этот способ рекомендован только для тех, кто хорошо знакомых с OpenBSD.
Порт PHP разбит на ядро и модули. Модули генерируют подпакеты для всех поддерживаемых модулей PHP. Если какие-либо из них
вам не нужны, используйте FLAVOR <command>no_*</command>. Например, для пропуска
модуля imap, установите FLAVOR в <command>no_imap</command>.
PHP также компилируют из исходного кода <link xlink:href="&url.openbsd.ports;">дерева портов</link>.
Способ рекомендуют только пользователям с опытом работы в ОС OpenBSD.
Порт PHP разделили на ядро и модули. Модули генерируют подпакеты для каждого модуля,
который поддерживается PHP. Параметр вроде <command>no_*</command>, где вместо
символа звёздочки указали название модуля, не станет создавать модуль.
Например, чтобы пропустить и не создавать модуль imap,
устанавливают параметр <command>no_imap</command>.
</simpara>
</sect2>
<sect2 xml:id="install.unix.openbsd.faq">
<title>Стандартные проблемы</title>
<itemizedlist>
<listitem>
<simpara>Apache и Nginx более не являются веб-серверами по умолчанию для OpenBSD,
но их очень легко найти и поставить из портов и пакетов. Новый сервер по умолчанию
<simpara>
Веб-серверы Apache и Nginx больше не веб-серверы по умолчанию для OpenBSD,
но они доступны в портах и пакетах. Новый сервер по умолчанию
называется 'httpd'.
</simpara>
</listitem>
<listitem>
<simpara>Стандартная установка httpd работает в
<link xlink:href="&url.openbsd.chroot;">chroot(2) окружении</link>, что запрещает PHP
доступ к файлам вне <filename>/var/www</filename>. Так что вам понадобится
создать директорию <filename>/var/www/tmp</filename> для сохранения сессионных
файлов PHP, или использовать альтернативный бэкенд для управления сессиями.
К тому же, сокеты баз данных будет необходимо размещать в chroot, либо слушать
на интерфейсе <filename>localhost</filename>. Если вы используете функции работы с
сетью, некоторые файлы из <filename>/etc</filename>, такие как
<filename>/etc/resolv.conf</filename> и <filename>/etc/services</filename> необходимо
будет поместить в <filename>/var/www/etc</filename>.
В OpenBSD, пакет PEAR автоматически устанавливается в правильные директории chroot.
<simpara>Стандартная установка httpd работает
<link xlink:href="&url.openbsd.chroot;">в изоляции chroot(2)</link>, что запрещает PHP
доступ к файлам вне каталога <filename>/var/www</filename>. Поэтому потребуется
создать директорию <filename>/var/www/tmp</filename>, чтобы сохранять файлы
PHP-сессий, или использовать альтернативный бэкенд для управления сессиями.
Сокеты баз данных потребуется разместить в изоляции или прослушиваться
на интерфейсе <filename>localhost</filename>. При работе с сетевыми функциями
отдельные файлы из каталога <filename>/etc</filename> наподобие
<filename>/etc/resolv.conf</filename> и <filename>/etc/services</filename> потребуется
переместить в каталог <filename>/var/www/etc</filename>.
Пакет OpenBSD репозитория PEAR автоматически устанавливается в правильные каталоги chroot.
</simpara>
</listitem>
<listitem>
<simpara>
Пакет модуля <link xlink:href="&url.gd;">gd</link> для OpenBSD требует установки Xorg.
Если он ещё не установлен при базовой установке путём добавления набора файлов <filename>xbase.tgz</filename>,
его можно добавить после установки (смотрите <link xlink:href="https://www.openbsd.org/faq/faq4.html#FilesNeeded">OpenBSD FAQ#4</link>).
Пакет модуля <link xlink:href="&url.gd;">gd</link> для OpenBSD требует
установки графического интерфейса Xorg. Пакет добавляют после базовой установки
(смотрите <link xlink:href="https://www.openbsd.org/faq/faq4.html#FilesNeeded">OpenBSD FAQ#4</link>),
если пакет ещё не установили при базовой установке путём добавления набора файлов <filename>xbase.tgz</filename>.
</simpara>
</listitem>
</itemizedlist>