URL: http://www.prowics-chat.ru/ -> HOST: www.prowics-chat.ru
URL: http://prowics-chat.ru/ -> HOST: prowics-chat.ru
URL: http://127.0.0.3/ -> HOST: 127.0.0.3
Выберите любой из 3-х вариантов адреса Вашего чата в Интернете. После этого определите, какой у него HOST, как в примере. Для этого отбросьте из будущего адреса Вашего чата слово "http://" и последний слеш - это и будет имя HOST`а. Не важно, что там: буквы (пример 1 и 2) или цифры (IP-адрес).
2.5.2 НАСТРОЙКА APACHE
Если у Вас еще нет Apache, то используйте тот, что поставляется в дистрибутиве chat-php-spb-ru-04_60.exe, и хранится в каталоге apache.
Если вы выбрали IP-адрес 127.0.0.1 и Apache взят из дистрибутива чата, то и делать ничего не надо, все настроено:
Listen 127.0.0.1:80
NameVirtualHost 127.0.0.1:*
<VirtualHost 127.0.0.1:*>
php_value magic_quotes_gpc 0
php_value register_globals 1
ServerAdmin a@b.ru
DocumentRoot c:/www/chat-php-spb-ru-04/www
ServerName 127.0.0.1
ErrorLog logs/chat.err
CustomLog logs/chat.log common
</VirtualHost>
Если у Вас уже установлен рабочий Apache на компьютере, то для размещения чата рекомендуется создать специальный виртуальный сервер prowics-chat:
Опишем этот сервер в файле виртуальных хостов D:\usr\Apache\conf\vhosts.conf:
#----prowics-chat
<VirtualHost 127.0.0.3> //задается IP-адрессервера
php_value magic_quotes_gpc 0
php_value register_globals 1
ServerAdmin a@b.ru // адресадминистраторасервера
DocumentRoot "/home/prowics-chat/chat-php-spb-ru-04/www/index.php" // папка расположения документов c чатом
ServerNamewww.prowics-chat// имя сервера
ErrorLog/home/prowics-chat/chat-php-spb-ru-04/daemon/logs/chat.err// расположение файла ошибок
CustomLog /home/prowics-chat/chat-php-spb-ru-04/daemon/logs/chat.logcommon // расположение файла доступа
</VirtualHost>//закрываем описание сервера
В конец файла С:\WINDOWS\system32\drivers\etc\hostsнужно добавить IP-адрес и имя сервера:
127.0.0.3 prowics-chat
"/home/prowics-chat/chat-php-spb-ru-04/" - будет корень чата, а подкаталог "www" - для PHP-файлов. Туда и должен указывать DocumentRoot. Создайте этот пустой подкаталог. Сделайте для проверки файл index.php:
<html> Чат CHAT.PHP.SPB.RU <? echo "работает"; ?></html>
И поместите его в подкаталог "www" - для PHP-файлов. Запустите Apache и убедитесь, что в браузере по адресу http://prowics-chat/chat-php-spb-ru-04 имеется тестовый index.php, который выдает два слова:
И до тех пор, пока на выбранном URL Вы не увидите эти слова, не переходите дальше, а настраивайте Apache до …
2.5.3 НАСТРОЙКА КОНФИГОВ ЧАТА
Самые важные настройки зависят от правильного выбора HOST`а.
● Откройте daemon/dima_chat.conf. Впишите имя хоста в поле "wwwhost":
set wwwhost "127.0.0.3";
и укажите локальный путь до чата:
set wwp "chat-php-spb-ru-04/";
Каждый раз при измении любого из этих 3-х параметров в _dima.php необходимо менять эти значения и в этом файле.
● Откройте www/_dima.php:
Впишите имя хоста в поле $wwwhost. В нашем примере имя хоста - "127.0.0.3".
● Впишите правильное значение для $wwp:
Если вы хотите держать чат НЕ В КОРНЕ вашего веб-сервера, т.е. не по адресу: "http://чат.домен.ру/", а в любом каталоге типа: "http://чат.домен.ру/любой/путь/" то вам нужно изменить параметр $wwp. Здесь нужно написать ту часть URL, которая находится после имени сервера:
http://имясервера/путь/до/начала/чата
● Впишите 2 случайных пароля для внутренних криптографических операций в переменные $rand_password и $cookie_pass.
● Впишите тип ОС в переменную $os.
● Впишите в массив $admlist имя вашего будущего логина и удалите те логины, которые там записаны по-умолчанию. Не забудьте после настройки чата зарегистрировать этот логин, чтобы получить права.
2.5.4 ЗАПУСК ЧАТ-СЕРВЕРА
Перейдите в каталог daemon и запустите "run_this.bat". Убедитесь, что в черном окошке запускается программа, которая не завершается в течении 5-10 секунд с сообщениями об ошибках.
Фраза "Loaded" означает успешное завершение загрузки.
Если в черном окне промелькивает много сообщений и появляется командная строка ДОСа, то это неудачный старт программы. Читайте сообщения об ошибках.
Запустите Apache и зайдите браузером на "http://prowics-chat/", в нашем случае http://127.0.0.3. Чат должен работать:
Если Вы вообще ничего не видите, убедитесь, что Apache работает и ваш браузер настроен правильно: отключены дозвоны в Инет, прокси сервер, автономный режим и т.д.
Если возникает детектор ошибок, то внимательно читайте, что там написано. Это не проблема чата. Это ошибки неправильной настройки программы. Детектор ошибок придуман для упрощения налаживания чата и для простого способа поиска неполадок. Если что не так - сразу в логах (или и в логах и на экране) вы будете видеть сообщения о возникших проблемах.
Обратим внимание на часто встречающиеся проблемы.
● Чат работает с любым PHP 4.х, любым Apache 1.х и любой версией Windows и Unix.
● По настройкам PHP проверьте, что register_globals в on и magic_quotes_gpc в off. В чате есть защита от неправильной настройки этих двух параметров, поэтому не волнуйтесь, чат проверит их сам. Кроме того, используйте и качайте только последнюю версию чата.
● Как правильно задать $wwwhost и $wwp?
Откройте главную страницу чата из браузера: index.php?helpme=1. Вам выдадут то, что нужно записать в эти 2 переменных. Допустим: www.host.ru. Чтобы все правильно работало, вы должны ходить с этого момента по адресу http://www.host.ru, а не http://host.ru или http://chat.host.ru. Данное значение берется из параметра ServerName вашего виртульного хоста, заведенного в Apache для вашего домена.
● Что такое в адресной строке браузера: index.php?&fixhost=1 ?
Это попытка автоматически подкорректировать неправильную настройку $wwwhost. Значит лишь одно - в $wwwhost написано одно, а настоящий URL в браузере - другой. Например, если в $wwwhost вы написали "www.чат.ru", а пользователь пришел на адрес "чат.ru", то он будет принудительно перенаправлен на $wwwhost.
● Чат при установке не прописывает себя в автозапуск. Поэтому при включении компьютера нужно запустить 2 приложения - Apache и чат-сервер (файл run_this.bat для Windows или run_background для Unix).
● Вхожу успешно в чат (фрейм сообщений грузится). Но там пусто!
Если фрейм сообщений загрузился, но не выводится ничего (ни топика, ни сообщений), то откройте логи чат-сервера. Если в логе пишут Can't open z-channel.html, то значит в конфиге чата не настроена переменная set wwp "***". В противном случае возможно испорчен какой-то шаблон и из-за HTML ошибки ничего не рисуется на экран: проверьте из админовки шаблон топика, текст топика, файлы шаблоны в скинах, что вы меняли.
● нельзя в одностороннем порядке изменить параметры $wwwhost и $wwp в конфигурационных файлах. Если в одном из файлов Вы это поменяли, то во втором тоже нужно внести точно такое же исправление. Конфиги: _dima.php и dima_chat.conf.
3. УСТАНОВКА И НАСТРОЙКА ЧАТА ПОД LINUX/FreeBSD
Рассмотрим порядок установки программы CHAT.PHP.SPB.RU на Интернет-сервер провайдера/хостера/организации. 90% успеха - точное исполнение инструкций, буквально по каждому слову. Пропустите хотя бы один абзац/фразу/слово инструкций - чат работать не будет. Необходимо выполнять обычные пользовательские действия типа распаковки архива, выполнения готовых команд и правки файлов. После установки изучить все опции в _dima.php, _phpini.php, .htaccess, dima_chat.conf и документацию в readme.html, faq.html, unix.html.
Вся разница между Windows и Unix установкой заключается в следующем:
● Поставить при необходимости TCL (распаковать, ./configure; make; make install);
● Скачать libtbcload1.3.so по ссылке;
● Изменить файл run_this;
● В dima_chat.conf заменитьtbcload13.dll на libtbcload1.3.so;
● Настроить права chmod -R 777 /home/wwwchat/chat/daemon;
Больше отличий между Windows и Unix версиями установки чата нет. Просто для Windows уже есть готовый архив, который нужно распаковать и сразу запустить, а под Unix нужно еще немного подумать, настроить права, скачать библиотеки под Linux/FreeBSD и т.п. мелочи. Реально сделать нужно всего 5 операций.
Дополнительные настройки чата находятся в файлах, содержимое которых нужно знать наизусть:
● www/_dima.php;
● www/_phpini.php;
● www/.htaccess;
● daemon/dima_chat.conf.
При установке чата нужно копировать файлы на сервер вашего хостинг-провайдера. Если вы это делаете из CuteFTP или других подобных FTP-менеджеров, то включайте в них "бинарный режим пересылки данных" (binary mode), иначе будут скопированы испорченные файлы. В FTP-модуле файлового менеджера FAR Manager этот режим включен по-умолчанию и называется по другому - text mode (т.е. в FAR'е нужно выключить text mode, чтобы работал binary). Если скопировать файлы криво, то у них будет различаться длина и содержимое от того, что находится в архиве. В результате чат вылетит на ошибке "load_s_file error #10: Ошибка распаковки конфиг файла [имя_файла]", когда будет анализировать правильность формата файла.
Копируйте только из FAR Manager и проблем не будет. Как это сделать, будет описано ниже. Либо копируйте архив, а распаковывайте прямо в шелле.
Рекомендуется сначала поставить чат на Windows и убедитесь, что там все работает. Если не работает, то решить проблему сначала под Windows, только потом под Unix.
3.1 ПОДГОТОВКА К ИНСТАЛЛЯЦИИ ЧАТА