Основные инструкции по установке, обновлению и конвертации phpBB2 в phpBB3 можно найти в документе INSTALL, который входит в дистрибутив phpBB. Если вы собираетесь конвертировать phpBB 2.0.x в phpBB3, то мы настоятельно рекомендуем выполнить резервное копирование всех данных перед продолжением этого процесса!

Пользователи phpBB 3.0, 3.1 и бета-версий phpBB 3.2 не смогут напрямую обновить конференцию.

Мы не поддерживаем следующие типы установок:

• Версии, обновлённые с бета-версии phpBB и ниже до кандидатов в релиз и выше.
• Версии, сконвертированные с phpBB 2.0.x до бета-версии phpBB 3.0, 3.1 и 3.2.
• Бета-версии phpBB 3.0, 3.1 или 3.2.

Мы оказываем поддержку для следующих типов установок:

• Версии, обновлённые с phpBB 3.0 RC1, 3.1 RC1 и 3.2 RC1 до последней версии.
• Примечание: при использовании пакета автоматического обновления поддерживаются с phpBB 3.0.2 и выше. Для обновления установок phpBB ниже версии 3.0.2 сначала обновите его версии 3.0.2, а затем обновите до текущей версии.
• Версии, сконвертированные с phpBB 2.0.x до последней версии.
• Новые установки phpBB 3.1.x — только последняя выпущенная версия.
• Новые установки phpBB 3.2.x — только последняя выпущенная версия.

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

2.i. Локализация (i18n)

В настоящее время доступно множество языковых пакетов с включёнными локализациями встроенного стиля. Их можно найти на страницах языковых пакетов или в разделе «Языковые пакеты» нашей базы персонализации.

Дополнительную информацию о языковых пакетах смотрите на странице https://www.phpbb.com/languages.

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

Установка языковых пакетов чрезвычайно проста: загрузите нужный вам языковый пакет, распакуйте его и с помощью FTP загрузите папки language и styles в корень конференции. Не нарушайте структуру файлов и папок при выполнении этого действия! После загрузки файлов на сервер перейдите в «Панель администратора -> Персонализация -> Языковые пакеты» и установите появившийся там языковой пакет. Более подробное описание процесса приведено в статье базы знаний «Как установить языковой пакет».

Если вы не нашли нужного вам языкового пакета, то посетите наш форум «[3.2.x] Translations». Там вы найдёте тему со списком доступных или готовящихся к выпуску языковых пакетов. Если вы хотите добровольно перевести на язык, которого в настоящее время нет в списке, или помочь в улучшении существующего языкового пакета, вы можете подать заявку стать переводчиком.

2.ii. Стили

Хоть мы и гордится стилями, включёнными в состав phpBB, но, тем не менее, мы прекрасно понимаем, что они не могут быть по вкусу абсолютно всем людям. Поэтому phpBB поддерживает другие стили и позволяет легко переключаться между ними. Сначала вам необходимо найти и загрузить понравившийся стиль (или несколько стилей). Вы можете найти их в разделе «Стили» нашей базы персонализации.

Дополнительную информацию о стилях смотрите на странице https://www.phpbb.com/styles

Обратите внимание, что стили, загруженные с других сайтов и предназначенные для phpBB2, не будут работать в phpBB3. Также важно, чтобы стили были обновлены в соответствии с текущей используемой вами версией phpBB.

После загрузки стиля его необходимо распаковать (или загрузить распакованное содержимое) в папку styles. После распаковки файлов перейдите в «Панель администратора -> Персонализация -> Управление стилями -> Установка стилей». Там вы увидите новый стиль, доступный для установки. Нажмите кнопку «Установить стиль» и новый стиль станет доступен всем пользователям.

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

2.iii. Расширения

Мы гордимся тем, что у нас процветают расширения. Эти расширения ещё больше расширяют возможности стандартного phpBB и могут быть найдены в разделе «Расширения» нашей базы персонализации.

Дополнительную информацию о расширениях смотрите на странице https://www.phpbb.com/extensions

Помните, что о различных ошибках или других проблемах, появившихся после добавления какого-либо расширения, не следует сообщать в систему хранения отчётов об ошибках, которая описана ниже. Сначала отключите расширение и посмотрите, не решена ли проблема. Любую поддержку расширения следует искать только в форуме «Discussion/Support» для этого расширения.

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

phpBB может показаться трудноватым в освоении новым пользователям, особенно в отношении настройки прав доступа. Первое, что вам следует сделать — это прочесть страницу часто задаваемых вопросов (FAQ), которая охватывает несколько самым популярных вопросов, задаваемых новичками. Если вы нуждаетесь в дополнительной помощи, то есть ещё несколько мест, которые вы можете с большим успехом посетить.

3.i. Документация phpBB

Исчерпывающую документацию по использованию phpBB можно прочесть, перейдя по следующему адресу:

https://www.phpbb.com/support/docs/en/3.2/ug/

Данное руководство охватывает всё, начиная с установки, и заканчивая настройкой прав доступа и управления пользователями.

3.ii. База знаний

База знаний состоит из ряда подробных статей о некоторых распространённых проблемах, с которыми могут столкнуться пользователи phpBB. Базу знаний можно найти по следующему адресу:

https://www.phpbb.com/kb/

3.iii. Форумы сообщества

Проект phpBB поддерживает процветающее сообщество, в котором множество людей жертвуют своим временем для бескорыстной поддержки пользователей. Наше сообщество расположено по следующему адресу:

https://www.phpbb.com/community/

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

3.iv IRC-чат (Internet Relay Chat)

Другим местом, в котором вы можете найти помощь, является наш IRC-канал. Он работает в сети Freenode IRC по адресу irc.freenode.net на канале #phpbb и может быть доступен с помощью хороших IRC-клиентов (mIRC, XChat, Opera и так далее). Не злоупотребляйте этой услугой и будьте предельно вежливы с другими пользователями.

Также доступны другие каналы IRC. Весь список каналов смотрите на странице https://www.phpbb.com/support/irc/.

Это стабильный выпуск phpBB. По большому счёту ветка phpBB 3.2.x является замороженным (или функционально завершённым на текущий момент) проектом. Новые версии этой ветки будут направлены лишь на исправление найденных ошибок и проблем в безопасности. Следующим крупным выпуском с новыми возможностями будет phpBB 3.3, который в настоящее время разрабатывается. Пожалуйста, не спрашивайте, когда будет завершена разработка версии 3.3. Точной даты выпуска не знаем даже мы — разработчики!

Лица, заинтересованные в разработке phpBB, могут следить за развитием на конференции разработчиков:

http://area51.phpbb.com/phpBB/

Обратите внимание на то, что конференция разработчиков не должна использоваться вами для получения помощи по phpBB (для этого существует основное сообщество поддержки).

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

http://tracker.phpbb.com/browse/PHPBB3

Мы очень ценим любые сообщения о найденных ошибках (чем больше сообщений, тем лучше и стабильнее будет phpBB), но в то же время просим вас выполнить несколько простых шагов перед добавлением нового отчёта:

• Во-первых, определите, является ли найденная вами ошибка способной к многократным повторениям. Как это определить — зависит от рассматриваемой ошибки. Если ошибка является способной к многократным повторениям, то возможно она действительно кроется в phpBB (или в связанных компонентах). А если ошибка не может быть воспроизведена повторно, или она проявляется хаотически, то это может означать, что были какие-то временные трудности, связанные с работой вашего сервера, пользователь, делающий что-нибудь глупое и тому подобное. Сообщения об ошибках, не способных к многократным повторениям, могут значительно замедлить наши попытки исправления реальных ошибок.
  
  
• Затем не поленитесь просмотреть существующие отчёты об ошибках, чтобы увидеть, имеется ли ваша ошибка (или подобная вашей) в списке существующих ошибок. Если подобная ошибка будет найдена, то просто добавьте к ней своё сообщение, вместо создания второго дублирующего отчёта (несколько одинаковых отчётов замедляют ответ от нас).
  
  
• Пройдитесь по форумам (используйте поиск!), посмотрите, обсуждали ли другие люди что-нибудь подобное найденной вами ошибке. Тем не менее, как упомянуто выше, не размещайте сообщений об ошибках на форумах поддержки, если они не имеют способности к многократному повторению, или вы уверены, что ошибка связана скорее с тем, что вы сами сделали с phpBB.
  
  
• Если ошибки, подобной найденной вами, не найдётся, то не стесняйтесь — добавьте свой отчёт.

Если вы решили отправить отчёт об ошибке (не найденной), то сначала войдите в систему (имя и пароль, используемые вами на наших форумах поддержки), и включите в отчёт следующие подробности:

• Тип и версия сервера. Например, Apache 2.2.3, IIS 7, Sambar и так далее.
• Версия и режим работы PHP. Например, PHP 5.4.0 как модуль, PHP 5.4.0, выполняющийся как CGI и так далее.
• Тип и версия базы данных. Например, MySQL 5.0.77, PostgreSQL 9.0.6, MSSQL Server 2000 (через ODBC) и так далее.

Тип и версия базы данных указаны в панели администратора.

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

Если у вас есть своё мнение насчёт того, как исправить эту ошибку, и если вы уверены, что ваше решение поможет исправить эту ошибку (и если оно соответствует нашим принципам кодирования), а также не вызовет дальнейших проблем и несовместимостей, то сообщите о своём решении. Возможно, именно ваше решение поможет исправить ошибку. Обратите внимание, что рекомендации по кодированию несколько отличаются между различными версиями phpBB. Для phpBB 3.2.x руководство по кодированию можно найти здесь: http://area51.phpbb.com/docs/32x/coding-guidelines.html

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

5.i. Ошибки, связанные с безопасностью

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

https://www.phpbb.com/security/

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

• Иногда бывает невозможно завершить процедуру конвертации phpBB2 в phpBB3 на больших конференциях и на некоторых хостингах.
• Иногда бывает невозможно завершить процедуру обновления на больших конференциях на некоторых хостингах.
• Смайлики, размещённые непосредственно после тегов BBCode, не будут анализироваться. Смайлики всегда должны отделяться пробелами.

phpBB 3.2.x использует новые функции, добавленные в PHP 5.4. Поэтому для запуска phpBB мы рекомендуем вам перейти на последнюю стабильную версию PHP. Минимальной версией является PHP 5.4.0, а максимальная поддерживаемая версия — это последняя стабильная версия PHP.

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

Эта конференция разработана и протестирована в средах Linux и Windows (среди прочих) под Apache с использованием MySQL 3.23, 4.x, 5.x, MariaDB 5.x, PostgreSQL 8.x, Oracle 8, и SQLite 3. На версиях PHP в диапазоне от 5.4 и выше 5.6.x до 7.0 проблем не выявлено.

7.i. Уведомление о вопросах безопасности PHP

В настоящее время нет известных проблем, связанных с безопасностью PHP.

phpBB — это бесплатное программное обеспечение, выпущенное в соответствии с GNU General Public License версии 2 (GPL-2.0). Copyright © phpBB Limited. Полную информацию об авторских правах и лицензии можно найти в файле docs/CREDITS.txt.

Перевод данного документа на русский язык выполнил Kastaneda.