Если вы имеете элементарные знания по использованию протокола FTP и уверены, что ваш хостинг-провайдер позволяет использование phpBB3, то вы можете использовать эти шаги для быстрой установки. Для более подробных объяснений вы должны пропустить этот раздел, и перейти в раздел 2 ниже.

1. Распакуйте дистрибутив phpBB3 в локальный каталог вашей системы.
2. Загрузите все файлы дистрибутива (с сохранением структуры каталогов) в доступный каталог на вашем веб-сервере или учётной записи у хостинг-провайдера.
3. Измените права доступа на файл config.php, чтобы он был доступен для записи всеми (666 или -rw-rw-rw- с помощью FTP-клиента).
4. Измените права доступа на следующие каталоги, чтобы они были доступны для записи всеми (777 или -rwxrwxrwx с помощью FTP-клиента):
   store/, cache/, files/ и images/avatars/upload/.
5. С помощью браузера перейдите в каталог phpBB3 с добавлением install/index.php или install/. Например, http://www.mydomain.com/phpBB3/install/, http://www.mydomain.com/forum/install/ и т.п.
6. Перейдите на вкладку Установка, выполните все шаги и заполните все требуемые поля.
7. Измените права доступа на файл config.php, чтобы он был доступен для записи только вам (644 или -rw-r--r-- с помощью FTP-клиента).
8. phpBB3 теперь должен быть доступен. Пожалуйста, УБЕДИТЕСЬ, что вы прочитали раздел Важные (связанные с безопасностью) послеустановочные действия для всех методов установки.

Если вы испытываете трудности или не знаете, как продолжить какой-либо шаг установки, то будьте любезны прочесть этот документ до конца.

Для установки и использования phpBB3 требуются следующие технологии:

• Веб-сервер или учётная запись у хостинг-провайдера на любой операционный системе с поддержкой PHP
• База данных SQL, одна из:
  • MySQL 3.23 или выше (MySQLi поддерживается)
  • PostgreSQL 7.3+
  • SQLite 2.8.2+
  • Firebird 2.0+
  • MS SQL Server 2000 или выше (напрямую или через ODBC)
  • Oracle
• PHP 4.3.3+ (>=4.3.3, >4.4.x, >5.x.x, >6.0-dev (compatible)) с поддержкой базы данных, которую вы собираетесь использовать.
• Функция getimagesize() должна быть включена.
• Эти модули PHP не являются обязательными. Однако, если они доступны, это откроет дополнительные функции.
  • Поддержка zlib Compression
  • Поддержка Remote FTP
  • Поддержка XML
  • Поддержка Imagemagick
  • Поддержка GD

Если ваш веб-сервер или хостинг-провайдер не удовлетворяют вышеперечисленным требованиям, то боюсь, phpBB3 не для вас.

Установка phpBB3 изменяется в соответствии с вашим сервером и базой данных. Если вы имеете shell-доступ к своей учётной записи (например, через telnet или ssh), то вы можете загрузить полный архив phpBB3 (в двоичном режиме!) в каталог на вашем сервере и разархивировать его там.

Если у вас нет shell-доступа или вы не хотите использовать его, то вам нужно распаковать дистрибутив phpBB3 в локальный каталог вашей системы с помощью вашей любимой программы для распаковки архивов, например, winzip, rar, zip и т.д. Из этого каталога вы должны загрузить ВСЕ файлы с помощью протокола FTP (с полным сохранением структуры каталогов и имён файлов) на ваш сервер. Убедитесь, что оригинальный регистр имён файлов сохранён. НЕ меняйте регистр имён файлов, это может вызвать ошибки в дальнейшем.

Все файлы .php, .inc, .sql, .cfg, .html и .txt должны быть загружены на сервер в режиме ASCII, а все графические файлы должны быть загружены в режиме BINARY. Если вы незнакомы с этими терминами, то обратитесь к документации вашего FTP-клиента. В большинстве случаев всё это прозрачно (то есть вы не должны задумываться об этом) обрабатывается вашим FTP-клиентом, но если у вас впоследствии возникнут трудности, то вы должны убедиться, что файлы загружены так, как описано здесь.

phpBB3 снабжён английским языком. Однако отдельно доступно множество других языковых пакетов. Если вы не понимаете по-английски, то можете перед установкой установить один или более языковых пакетов. Во время дальнейшей установки вам будет позволено выбрать язык по умолчанию из доступных (впоследствии вы сможете изменить эту установку по умолчанию). Если нужна дополнительная информация относительно языковых пакетов (где их взять и как установить), то смотрите файл README.

Как только все файлы будут загружены на сервер, вы должны будете указать в вашем браузере путь до каталога с добавлением install/. Например, если ваше доменное имя www.mydomain.tld и вы разместили phpBB3 в каталоге /phpBB3, то в браузере вы должны ввести путь http://www.mydomain.tld/phpBB3/install/ или (в качестве альтернативы) http://www.mydomain.tld/phpBB3/install/index.php. После этого появится страница установки phpBB3.

Обзор

Страница предоставляет вам общую информацию о phpBB. А также дает возможность ознакомиться с лицензией, под которой выпущен phpBB3 (General Public License), и предоставляет информацию о получении поддержки. Для начала установки перейдите на вкладку Установка и следуйте инструкциям.

Требования

На первой странице, которую вы увидите после начала установки, приведен список требований. phpBB3 автоматически проверяет установлено ли всё необходимое для запуска установки на вашем сервере. Для продолжения установки вы должны иметь установленными по крайней мере минимальную версию PHP и одну базу данных. Кроме того важно, чтобы все указанные каталоги были доступны и действительно имели правильно установленные права доступа. Смотрите описание каждой секции, чтобы узнать, являются ли эти требования обязательными для продолжения установки и запуска phpBB3. Если все правильно, то вы можете начать установку с помощью кнопки Начать установку.

Настройки базы данных

Теперь вы должны решить, какую базу данных (БД) вы будете использовать. Смотрите раздел Требования для получения информации о поддерживаемых базах данных. Если вы не знаете настроек вашей базы данных, свяжитесь с вашим хостером и узнайте их у него. Вы не сможете продолжить установку без этих данных. Вам нужно знать:

• Тип базы данных - той, которую вы будете использовать.
• Имя сервера БД или DSN - адрес сервера базы данных.
• Порт сервера БД - порт сервера базы данных (не нужно указывать в большинстве случаев).
• Название базы данных - имя базы данных на сервере.
• Имя пользователя БД и Пароль к БД - данные для доступа к базе данных.

Вы не должны изменять Префикс для таблиц в настройках базы данных, если только вы не собираетесь использовать несколько установок phpBB в одну базу данных. Но если вам это необходимо, то вы должны изменить Префикс, чтобы все установки phpBB работали.

После того как вы ввели все данные, вы можете продолжить процесс установки нажатием кнопки Следующий шаг. Теперь phpBB3 проверит возможность соединения с базой данных с помощью введенных вами данных и проверит наличие таблиц с указанным вами префиксом.

Получение ошибки Could not connect to the database может означать, что вы ввели неверные данные для соединения с базой данных. Следовательно, phpBB не сможет продолжить установку и последующая работа невозможна. Вы должны проверить все введенные вами данные для соединения с базой данных и попробовать ещё раз. Если вы не уверены в правильности ваших данных, то вы должны обратиться к своему хостеру.

Если раньше вы устанавливали phpBB в эту же базу данных и с этим же префиксом, то phpBB сообщит вам об этом, и вы должны будете сменить префикс на какой-либо другой.

Если вы видите сообщение об успешном соединение с базой данный, то вы можете перейти к следующему шагу.

Сведения об администраторе

Теперь вы должны создать администратора конференции. Этот пользователь получит полный администраторский доступ, и он/она станет первым пользователем вашей конференции. Все поля на этой странице обязательны для заполнения. Здесь вы так же можете установить язык по умолчанию для вашей конференции. Дистрибутив phpBB включает в себя только английский языковой пакет. Но вы можете скачать другие языковые пакеты с www.phpbb.com и добавить их перед или после установки.

Файл конфигурации

В этом шаге phpBB пробует записать файл конфигурации автоматически. Файл конфигурации необходим phpBB для запуска и работы. Он содержит все настроки базы данных. Следовательно, без него phpBB не сможет получить доступ к базе данных.

Обычно автоматическая запись конфигурационного файла проходит без проблем. Но в некоторых случаях она может не пройти из-за неправильных прав доступа. В этом случае вы должны загрузить файл вручную. phpBB попросит вас сначала скачать файл config.php и предоставит вам дальнейшую инструкцию. Пожалуйста, прочтите эту инструкцию очень внимательно. После того как вы загрузите файл, нажмите Следующий шаг, чтобы перейти к последнему шагу. Если Следующий шаг возвращает вас к предыдущей странице и не выдает сообщения об успешной записи, значит вы не закачали или неправильно закачали файл.

Расширенные настройки

Расширенные настройки позволяют вам установить некоторые параметры вашей конференции. Они являются дополнительными, и вы всегда сможете их изменить позже. Если вы не уверены в том на что влияют эти настройки, переходите к следующему шагу и завершите установку.

Если установка прошла успешно, то вы можете использовать кнопку Вход, чтобы посетить Администраторский раздел. Поздравляем, вы успешно установили phpBB3. Но вперед, есть ещё работа впереди!

Если прочитав это руководство, вы так и не смогли установить и настроить phpBB3, то прочтите раздел «Получение помощи по phpBB3», чтобы узнать где вы можете получить помощь.

Если вы хотите конвертировать ваш phpBB 2.0.x, то должны обратиться к разделу Конвертация phpBB 2.0.x в phpBB 3.0.x для получения информации о том, как это сделать. В противном случае вы должны удалить установочный каталог. Так как, пока он существует на вашем веб-сервере, вы будете иметь доступ только к Администраторскому разделу.

Если вы в используете полноценную версию phpBB3, то обновить её до более новой версии очень легко. Вы должны загрузить один из четырех пакетов и, в зависимости от вашего выбора, выполнить необходимые действия. Обратите внимание: перед обновлением мы настоятельно рекомендуем сделать полную копию вашей базы данных и существующих исходных файлов phpBB3! Если вы не знаете, как это сделать, то обратитесь за помощью к вашему хостинг-провайдеру.

Убедитесь, что вы обновили исходные файлы phpBB3 перед запуском файла database_update.php.

4.i. Полный пакет

Полный пакет предназначается для новой установки. Но если вы по каким-либо причинам хотите заменить все файлы, то используйте его.

Сначала сохраните ваш существующий файл config.php. Затем удалите все существующие файлы phpBB3. Вы можете оставить ваши каталоги files/ и images/. Так же вы можете оставить дополнительно установленные вами стили. Теперь загрузите новые файлы phpBB3 (смотрите раздел Новая установка в случае необходимости). Потом загрузите сохраненный вами файл config.php, заменяя новый. Так же вы можете просто заменить все существующие файлы файлами из дистрибутива phpBB3, за исключением config.php.

Теперь вы должны выполнить install/database_update.php, который, в зависимости от вашей предыдущей версии phpBB3, внесет необходимые изменения в базу данных. Во время этой процедуры вы можете получить сообщения FAILURES, но они не должны быть причиной для беспокойства. Однако если вы получите сообщение ERROR и процесс выполнения остановится, то вы можете обратиться за помощью на нашу конференцию поддержки или в систему хранения отчётов об ошибках.

После выполнения install/database_update.php вы можете перейти в Администраторский раздел и удалить установочный каталог.

4.ii. Только изменённые файлы

Этот пакет содержит несколько архивов, каждый из которых содержит файлы, изменённые до последней версии. Вы должны выбрать соответствующий архив для вашей текущей версии. Например, если у вас установлена версия 3.0.0, то вы должны выбрать файл phpBB-3.0.0_to_3.0.1.zip/tar.gz.

Структура каталогов в архивах сохранена таким образом, что вы можете (если хотите) просто загрузить содержимое архива на сервер, перезаписав при этом обновлёнными файлами файлы старой версии. Но при этом не забывайте, что если у вас установлены какие-либо модификации, то они перестанут работать. В этом случае вам нужно будет предварительно заново установить эти модификации на загружаемые файлы.

После обновления файлов вам нужно с помощью вашего браузера запустить файл install/database_update.php. Этот файл произведёт в базе данных все необходимые изменения, требуемые для новой версии, а также увеличит номер версии.

4.iii. Patch-файл

Возможно, Patch-файл является наилучшим решением для конференций с установленными модификациями или с другими изменениями в файлах phpBB, если вы не хотите повторно вносить изменения во все файлы. Для использования Patch-файлов вы должны иметь доступ к командной строке UNIX и приложению patch. Если вы не имеете такого доступа, но хотите использовать описанный подход, то мы рекомендуем вам воспользоваться Автоматическим обновлением, описанным ниже.

Для обновления с предыдущих версий предоставлено несколько Patch-файлов. Выберите нужный вам файл. Например, если у вас установлена версия 3.0.0, то вы должны выбрать файл phpBB-3.0.0_to_3.0.1.patch. Поместите этот файл в корневой каталог вашего phpBB3 (в котором находятся файлы index.php, viewforum.php, и т.д.). После этого в командной строке введите следующую команду: patch -cl -d [PHPBB DIRECTORY] -p1 < [PATCH NAME] (где PHPBB DIRECTORY - корневой каталог установленной конференции (например, phpBB3) и PATCH NAME - имя выбранного вами Patch-файла). Обычно процедура обновления с помощью вышеописанного способа происходит быстро и без вывода каких-либо сообщений об ошибках.

Но если во время обновления ошибки всё-таки произошли, то используйте метод Только изменённые файлы для ручной замены файлов, которые не удалось обновить с помощью Patch-файла. После этого вручную добавьте модификации для этих файлов. Либо вы можете посмотреть файлы .rej, чтобы определить в каких конкретно действиях произошли ошибки и попробовать исправить эти ошибки вручную.

После обновления не забудьте удалить patch-файл (или файлы), а также запустите файл install/database_update.php после обновления файлов, который произведёт в базе данных все необходимые изменения, требуемые для новой версии, а также увеличит номер версии.

4.iv. Автоматическое обновление

Автоматическое обновление (в отличии от остальных) поддерживает обновление только с предыдущей до последней выпущенной версии. Пакет автоматического обновления предназначен для использования вместе с инструментом автоматического обновления.

Чтобы выполнить обновление вы должны следовать инструкциям из Администраторского раздела -> Система. Там будет указано, что ваша версия phpBB устарела и будут даны инструкции по обновлению. Либо вы можете воспользоваться следующими инструкциями сами.

• Перейдите на страницу загрузки и скачайте последний пакет обновления.
• Загрузите содержимое архива в каталог с установленным phpBB3. Требуется только каталог install/. При загрузке соблюдайте структуру каталогов и файлов.
• После того как каталог install/ будет загружен, phpBB3 автоматически отключится.
• С помощью браузера перейдите в каталог install/, например http://www.example.com/phpBB3/install/
• Перейдите на вкладку Обновление и следуйте инструкциям.

 

4.v. Для всех методов обновления

Если у вас имеются неанглийские языковые пакеты, то желательно обновлять их. Иногда в новые версии добавляются новые языковые переменные, которые хоть и не являются существенными, но тем не менее могут быть полезны для пользователей. В настоящее время не все языковые пакеты обновлены, поэтому периодически проверяйте изменения ваших языковых пакетов.

Этот раздел поясняет шаги, необходимые для конвертации существующей установки phpBB2 в phpBB3.

5.i. Необходимые действия перед конвертацией

Перед конвертированием мы настоятельно рекомендуем выполнить полное резервное копирование существующей базы данных и всех файлов! Если вы не знаете, как это сделать, то обратитесь за помощью к своему хостинг-провайдеру. Для конвертирования вы должны уже иметь отдельную установку phpBB3 в ту же базу данных (но с другим префиксом), что и старая установка phpBB 2.0.x. В основном вы должны следовать базовым инструкциям данным разделе Новая установка. Не перезаписывайте любые старые файлы - установите phpBB3 в отдельный каталог.

После создания резервной копии и установки phpBB3 вы можете начать конвертацию.

Учтите, что процесс конвертации требует от пользователя базы данных прав на выполнение команд CREATE и DROP.

5.ii. Конвертация

Для начала конвертации перейдите в установочный каталог вашего phpBB3 (точно так же, как вы делали при установке). Теперь вы увидите новую вкладку Конвертация. Перейдите на неё.

Как и установка, конвертация автоматизирована. Ваши таблицы phpBB 2.0.x в базе данных останутся нетронутыми, как и файлы phpBB 2.0.x. При конвертации будут заполнены таблицы phpBB3 и скопированы дополнительные данные в каталог phpBB3. Так сделано специально, чтобы в случае неудачи вы могли запустить конвертацию заново или продолжить её с шага, на котором остановились. А ваш phpBB 2.0.x останется неизмененным. Мы так же рекомендуем отключить ваш старый phpBB 2.0.x на время конвертации. В противном случае вы можете получить ошибки (в виде непоследовательных данных) после конвертации.

Учтите, что конвертация может занять некоторое время, а при определенных условиях, со стороны хостинг-провайдера, попытка конвертации даже может завершиться неудачей (например, из-за ошибки веб-сервера или других ошибок «превышения времени»). Если это так, то вы должны обратиться к своему хостинг-провайдеру за разрешением превысить ограничения ресурсов на время выполнения конвертации (и тогда вы сможете достигнуть положительного результата).

После конвертации ваша конференция будет сразу же доступна. В случае возникновения ошибок сообщите о них в систему хранения отчётов об ошибках или посмотрите конференцию поддержки для нахождения решения вашей проблемы (смотрите файл README).

5.iii. Необходимые действия после конвертации

Сразу после успешной конвертации, вы должны произвести несколько действий, помимо проверки того, что ваш phpBB3 работает и корректно отображается.

Первое, что вы можете сделать, это перейти в Администраторский раздел и проверить каждый пункт конфигурации на вкладке Общие. После этого проверьте названия/описания форумов, если вы использовали там HTML. Так же проверьте остальные вкладки в Администраторском разделе, относящиеся к правам доступа, смайлам, изображениям, званиям и др.

При конвертации поисковый индекс не создается и не переносится. Это значит, что после конвертации вы не сможете найти любые слова или части слов. Мы рекомендуем вам создать поисковые индексы, перейдя в Администраторский раздел -> Обслуживание -> База данных -> Поисковый индекс.

После проверки настроек в Администраторском разделе, вы должны удалить каталог install/, чтобы включить вашу конференцию. Конференция будет отключена, пока вы не сделаете это.

Теперь, ощущая удовольствие от использования phpBB3, вы наверняка хотите изменить название и расположение phpBB3 в соответствии с вашим прежним phpBB 2.0.x. С phpBB3 вы не испытаете никаких проблем по этому поводу, но вы должны проверить настройки cookies в Администраторском разделе до совершения этих операций.

5.iv. Общие проблемы конвертации

Сломанные нелатинские символы Скрипт конвертации предполагает, что база данных в исходном phpBB 2 закодирована в соответствии с кодировкой указанной в файле lang_main.php языкового пакета по умолчанию. Отредактируйте указаный файл, чтобы кодировка соответствовала кодировке базы данных, и начните процесс конвертации заново.

http 500 / пустая страница Конвертация - требовательная к системным ресурсам процедура. Ограничения, наложенные вашим хостером могут вызвать проблемы. Самые общие проблемы: слишком низкие значения настроек PHP memory_limit и max_execution_time. Ограничения загрузки CPU тоже очень частая причина подобных ошибок, так же как и оганичение на количество запросов к базе данных. Если вы не можете изменить эти настройки, то обратитесь к своему хостеру или выполняйте конвертацию на другом компьютере. Конференция phpBB.com прекрасное место, чтобы попросить помощи.

Конвертация паролей Из-за кодировки utf-8, на которой базируется обработка паролей в phpBB3, не всегда возможно передать все пароли. Для паролей, "потерянных" в процессе конвертации, самым простым решением будет использование функции "Забыли пароль?"

Путь к прежней конференции Конвертеру необходим относительный путь к файлам старой конференции. Так, например, если старая конференция расположена по адресу http://www.yourdomain.com/forum, а phpBB3 расположен по адресу http://www.yourdomain.com/phpBB3, то правильным значением пути к старой конференции будет ../forum. Учтите, что пользователь веб-сервера должен иметь доступ к исходным установочным файлам.

Исчезнувшие изображения Если ваш языковой пакет по умолчанию не содержит всех изображений, то некоторые изображения могут отсутствовать. Всегда используйте полный языковой пакет для языка по умолчанию.

Смайлы В процессе конвертации вы могли видеть предупреждения о файлах изображений, копирование которых не удалось. Это могло произойти в случае, если имена файлов старой конференции совпадают с именами файлов phpBB3. Скопируйте эти файлы вручную после конвертации, если вы хотите использовать старый набор смайлов.

После успешной установки/обновления phpBB3 вы ДОЛЖНЫ удалить каталог install/. Наличие этого каталога на веб-сервере после завершения установки является очень серьёзной потенциальной «дырой» в безопасности вашей конференции, которая может привести к удалению или изменению файлов злоумышленниками. Имейте в виду, до тех пор, пока этот каталог не будет удален, ваш phpBB не будет работать, а будет выводить предупреждающее сообщение. Помимо этого важного каталога, вы также можете удалить каталог docs/. Он не требуется для работы форума.

После удаления указанных каталогов вы должны перейти в Администраторский раздел. В зависимости от исхода установки вас может туда перенаправить автоматически. Если этого не произойдёт, то войдите в систему под именем администратора, указанного вами во время установки/обновления, и щёлкните по ссылке «Администраторский раздел», которая находится внизу любой страницы. Убедитесь в правильности общих настроек форума Администраторский раздел -> Общие.

6.i. Загружаемые аватары

phpBB3 поддерживает несколько методов, которые позволяют пользователям выбирать себе аватар (аватара в контексте конференций - это небольшой рисунок, выбираемый пользователем, и обычно размещаемый под его именем).

Два из этих методов позволяют пользователям загружать аватары со своего локального компьютера или с удалённого адреса URL. Если вы хотите включить эти методы, то сначала вы должны убедиться в правильности путей к загружаемым аватарам в Администраторский раздел -> Общие -> Конфигурация -> Аватары. По умолчанию путь к каталогу для аватар images/avatars/uploads. Но вы вольны установить любой другой путь. Также убедитесь, что этот каталог доступен для записи. Это означает, что вы должны разрешить любому запись и чтение этого каталога. А как конкретно это сделать - зависит от вашего FTP-клиента и операционной системы на веб-сервере.

На UNIX-подобных системах на каталог для аватар вы должны установить права a+rwx (или ugo+rwx, или даже 777). Это можно сделать из командной строки на веб-сервере, используя команду chmod, или с помощью вашего FTP-клиента (используя «Права доступа», «chmod» или другие диалоговые окна «Прав доступа», пожалуйста, изучите документацию к вашему FTP-клиенту). Большинство FTP-клиентов выводят разрешения для Пользователя (Чтение, Запись, Выполнение), Группы (Чтение, Запись, Выполнение) и Прочих (Чтение, Запись, Выполнение). Вы должны пометить все предложенные флажки для установки нужных разрешений.

На Windows-системах необходимо убедиться, что каталог аватар не защищён от записи, и что он имеет глобальные разрешения на запись (смотрите вашу документацию для серверов или свяжитесь со своим хостинг-провайдером, если не уверены, как это сделать).

Но учтите, что установка глобального доступа на запись является потенциальной угрозой безопасности. В принципе маловероятно, что может произойти что-нибудь неприятное (типа полного удаления всех аватар), но всегда найдутся люди, способные на мелкие пакости. Поэтому по возможности проверяйте этот каталог и регулярно делайте резервные копии.

Это приложение с открытым исходным кодом выпущено под лицензией GPL. Для получения дополнительной информации смотрите исходный код и каталог «docs». Этот пакет и его содержимое является собственностью (c) 2000, 2002, 2005, 2007 phpBB Group. Все права защищены.
Перевод этого документа на русский язык выполнили Kastaneda и VVVas. Грамматические правки - Ацуши.