1. Общие сведения о TopServer

1.1. Что представляет собой TopServer

TopServer представляет собой серверный пакет или сервер приложений, включающий в себя веб-сервер Apache 2.0, интерпретатор PHP5 с библиотеками PECL, интерпретатор PERL5, сервера баз данных MySQL5 и SQLite2, FTP сервер SlimFTPd, а также обширные средства администрирования серверных компонентов. Причем указанные компоненты сервера приложений работают как единое целое.

Изначально сервер приложений TopServer создавался специально с целью упростить процедуру организации локального сервера приложений. Это весьма актуально для начинающих создателей сайтов, веб-программистов языка PHP и PERL, пользователей локальных сетей, и всех тех, кто имеет желание быстро установить и начать использовать локальный сервер приложений. TopServer можно также с успехом использовать и для хостинга большого колличества сайтов в рамках локальных сетей различного уровня.

После установки пакета Вы можете сразу начинать работу, не производя дополнительную конфигурацию сервера приложений и его компонентов (Apache, PHP и MySQL). На Ваш компьютер будут установлены необходимые модули сервера Apache, PHP, PERL, MySQL SQLite, FTP сервера, средства администрирования, а также каталоги, которые будут содержать Ваши HTML-документы, скрипты PHP, CGI-программы. Плюс к этому, дистрибутив включает в себя набор (около 400) исходных текстов различных PHP скриптов, которые вам могут пригодиться в качестве готовых примеров сценариев на PHP.

Важной особенностью сервера приложений TopServer является то, что конфигурационные файлы его компонентов несколько перестроены для вашего удобства и снабжены подробными комментариями директив и параметров на русском языке. Поэтому, если у Вас возникнет потребность в конфигурировании компонентов TopServer, а именно веб-сервера Apache, интерпретатора PHP и сервера баз данных MySQL, то это будет для Вас более простой задачей, чем прежде.

Удобная панель администрирования позволит Вам получить быстрый доступ к информации о компонентах сервера (Apache, PHP, MySQL, SQLite, FTP), произвести управление лога доступа Apache, а с помощью мощной системы администрирования MySQL phpMyAdmin Вы можете производить манипуляции с базами данных MySQL различной сложности. Также доступна система администрирования баз данных SQLite, система администрирования FTP сервера, файловый менеджер PHPfm и другие удобные и эффективные средства.

1.2. Цель создания TopServer

Целью создания пакета являлось желание удовлетворить потребность различных групп пользователей в сервере приложений, который был бы достаточно функциональным, простым в установке и использовании, удовлетворяющим потребности пользователей и администраторов локальных сетей, которым необходим инструмент для хостинга сайтов в рамках локальной сети, для создателей веб-сайтов, которым необходим инструмент для локального тестирования и размещения веб-страниц и скриптов и других груп пользователей. TopServer может использоваться для любых достойных целей любыми группами пользователей, сфера его применения ничем не ограничена.

Исходя из благотворительных побуждений, серверный пакет TopServer всех версий распространяется и всегда будет распространяться бесплатно.

1.3. Поддерживаемые версии ОС Windows

TopServer изначально создавался с использованием особенностей систем Windows серии NT, включая NT/2000/XP/2003. В связи с этим, Windows 95 и Windows 98 не поддерживаются.

Вероятно, вскоре будут созданы отдельные редакции TopServer специально для устаревших ОС Windows 9x. Действительно, изначально TopServer создавался только для Windows NT/2000/XP/2003. Это является оправданным, так как на домашних компьютерах (десктопах) большинство предпочитает использовать именно эти операционные системы.

Редакций TopServer для Unix (Linux) в данный момент не существует.

1.4. Минимальные системные требования для TopServer

Основные требования к аппаратной части компьютера практически не ограничены, за исключением объема свободного пространства на жестком диске, размер которого должен быть не менее 70 мб. Желательно наличие сетевой карты (для внешнего обмена данными).

Необходим установленный протокол TCP/IP.

2. Установка TopServer

2.1. Требования к установке

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

 а) Для установки TopServer необходимы права администратора Windows. Зайдите в Windows с правами администратора для дальнейших действий.

 б) Перед установкой TopServer необходимо убедиться в отсутствии установленных ранних версий и редакций TopServer. Это касается TopServer 1.0, взамен которого устанавливается TopServer 2.0. Это связано с разной топологией указанных версий TopServer. Поэтому, собираясь устанавливать TopServer 2.0, сначала удалите TopServer 1.0, предварительно сохранив необходимые документы, скрипты и прочие файлы.

Также убедитесь в отсутствии серверных компонентов, входящих в состав TopServer, а именно предустановленных веб-сервера Apache, интерпретатора PHP, интерпретатора PERL, сервера баз данных MySQL и FTP сервера. Помимо этого, убедитесь в отсутствии предустановленного веб-сервера IIS (Internet Information Server) от Microsoft. Как правило, он присутствует с составе Windows по умолчанию и, возможно, был установлен вами ранее.

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

Обратите также внимание на отсутствие серверов Apache и MySQL в списке установленных сервисов Windows. Для этого откройте в вашей Windows: Пуск >>> Панель управления >>> Администрирование >>> Службы. Поищите вероятно установленные серверные компоненты в виде сервисов Windows. Как правлило, сервис веб-сервера Apache имеет имя "Apache", сервис сервера баз данных MySQL имя "MySQL", "MySQL4" или "MySQL5" . Если указанные сервисы присутствуют, их необходимо полностью отключить, а еще лучше физически удалить. Обратите внимание и на сервис IIS (Internet Information Server), если он активен - также отключите или вообще удалите его.

Если указанные условия соблюдены, можете приступать к установке TopServer.

2.2. Процедура установки TopServer

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

В процессе установки вам будет предложено выбрать путь установки TopServer, вы можете выбрать произвольный путь установки. На завершающем этапе установки TopServer (после копирования файлов сервера) будет создан виртуальный диск T: и запущены все серверные компоненты сервера, а также добавлены необходимые ярлыки в програмное меню и ярлык автозапуска TopServer при запуске системы (автозагрузка).

Сразу после установки Вы можете начинать работу с TopServer.

2.3. Состав и структура устанавливаемого TopServer

Все файлы физически располагаются в выбранной вами директории, указанной при установке TopServer. Виртуально все основные файлы TopServer размещаются на отдельном виртуальном диске T: Структура каталогов упорядочена, достаточно проста для понимания и имеет Unix / Linux подобный стиль. И все-таки приведем состав основных каталогов для большего удобства (относительно корня виртуального диска T:

 1) docs: содержит лицензии на компоненты TopServer;

 2) email: данная директория содержит файлы электронных писем, сформированных фукнцией mail() языка PHP и переданных через заглушку Sendmail. В данном каталоге вы будете находить электронные письма, отправленные из PHP скриптов функцией mail();

 3) home: основная директория серверных объектов (документов *.html, *.ssi, скрипты *.php, *.pl, *.cgi и прочие). Серверные объекты располагаются в трех основных директориях:

» localhost [ директория объектов основного хоста - localhost. Данная директория является месторасположением серверных объектов (документов, скриптов), доступ к которым осуществляется через HTTP запрос к данному компьютеру по IP адресу или имени хоста, либо с локального компьютера - http://localhost. Помимо основных серверных объектов основного хоста, в данном каталоге располагаются и логи (протоколы) доступа и ошибок веб-сервера для основного хоста. В данном каталоге также находятся скрипты и статические страницы панели администрирования (подкаталог admin), а также некоторые страницы описания TopServer ];

»  users [ директория серверных объектов пользовательских каталогов. Пользовательские каталоги - это директории веб-сервера с именами типа http://localhost/~test, которые позволяют размещать серверные объекты (статичные страницы и скрипты) неограниченного числа пользователей и предоставлять к ним удаленный доступ, осуществляя таким образом хостинг пользовательских каталогов. Управление пользовательскими каталогами (создание, редактирование ограничений, удаление) осуществляется через панель администратора ];

» virtual [ директория виртуальных хостов и их серверных объектов. Концепция виртуальных хостов позволяет веб-серверу поддерживать несколько веб-ресурсов (сайтов) на одном сервере. Таким образом, существует возможность организовать хостинг множества сайтов, разместив их на одном сервере. По умолчанию доступны два тестовых виртуальных хоста: http://prime и http://second. Управление виртальными хостами (создание, редактирование условий, удаление) осуществляется через панель администратора ];

» errors [ директория страниц стандартных ошибок веб-сервера Apache. В случае, если возникает ошибка веб-сервера Apache, например, при отсутствии запрашиваемой страницы или запрете доступа к определенной странице или каталогу. Страницы ошибок снабжены комментариями, которые поясняют причину той или иной ошибки. Вы также можете редактировать страницы ошибок по вашему желанию ].

 4) usr: основная директория (каталог) серверных компонентов. В ее поддиректориях содержатся серверные компоненты TopServer:

» bin [ директория основных компонентов интерпретатора PERL и служебных скриптов управления TopServer на языке PERL ];

» lib [ директория библиотек интерпретатора PERL ];

» local [ директория веб-сервера Apache 2.0 (подкаталог Apache), FTP сервера SlimFTPd (подкаталог FTP), сервера баз данных MySQL5 (подкаталог mysql5), интерпретатора PHP (подкаталог PHP), служебных файлов TopServer (подкаталог program), "заглушки" Sendmail (подкаталог sendmail).

Директории расположения основных конфигурационных файлов компонентов TopServer:

a) файл конфигурации Apache (httpd.conf): /usr/local/Apache/conf/httpd.conf;

б) файл конфигурации PHP (php.ini): /usr/local/Apache/bin/php.ini;

в) файл конфигурации MySQL (my.ini): /usr/local/mysql5/my.ini;

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

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

 5) tmp: директория временных файлов серверных компонентов TopServer.

2.4. Обновление и удаление TopServer

Возможно, у Вас возникнет желание обновить TopServer, установив TopServer соответствующей версии. В таком случае вам нужно скачать обновления TopServer на сайте www.topserver.ru и установить их.

Удаление TopServer, как правило, не вызывает проблем. Для того, чтобы корректно удалить TopServer, используйте панель управления Windows (Пуск >>> Панель управления >>> Установка и удаление программ >>> TopServer).

(!) Крайне не рекоммендуется удалять TopServer "вручную", физически удаляя директорию TopServer, либо удаляя отдельные компоненты сервера.

3. Работа с TopServer

3.1. Первый запуск

Откройте веб-браузер (например Internet Explorer, Mozilla, FireFox, Opera и.т.п.) и в адресную строку браузера введите адрес http://localhost/. В результате Вы должны увидить стартовую страницу TopServer. Она выглядит примерно так:

На стартовой странице TopServer Вы найдете ссылки, которые позволяют провести проверку работоспособности компонентов сервера (CGI-BIN, PHP, SSI, PERL, MySQL и SQLite), проверку функционирования виртуальных хостов (http://prime/ и http://second/) и каталогов пользователей (http://localhost/~test), перейти на панель администрирования, получить основную общую и техническую информацию по TopServer.

3.2. Панель администрирования TopServer

В TopServer добавлена удобная панель администрирования, через которую Вы можете:

 а) Для Apache: Получать информацию о конфигурации веб-сервера Apache, просматривать и управлять логом (протоколом) доступа для основного хоста Apache с помощью менеджера лога доступа; редактировать файл конфигурации Apache, управлять виртуальными хостами с помощью менеджера виртуальных хостов (создавать виртуальные хосты, редактировать условия, удалять действующие виртуальные хосты); управлять пользовательскими каталогами с помощью менеджера пользовательских каталогов (создавать пользовательские каталоги, редактировать условия, удалять пользовательские каталоги).

 б) Для PHP: Получать информацию о конфигурации PHP; просматривать примеры простых PHP скриптов и результаты их работы; редактировать файл конфигурации PHP.

 в) Для MySQL: Просматривать информацию о текущем состоянии сервера баз данных MySQL; управлять базами данных MySQL с помощью мощной системы администрирования phpMyAdmin; редактировать файл конфигурации MySQL; создавать пользователей и соответствующие базы данных MySQL с помощью удобного скрипта.

 г) Для SQLite: Получать краткую информацию о сервере баз данных SQLite; управлять базами данных SQLite с помощью системы SQLiteManager;

 д) Для FTP: Управлять FTP сервером и его аккаунтами с помощью удобной системы администрирования PHPsFTPd;

Доступен также мощный файловый менеджер PHPfm, с помощью которого вы можете создавать каталоги и файлы, редактировать файлы, изменять имена каталогов и файлов, просматривать графические изображения, закачивать файлы на сервер, скачивать файлы с сервера и производить другие операции с каталогами и файлами.

Административная панель и все ее функции доступны только для локального компьютера, то есть только Вам. Удаленный доступ к административной панели и ее функциям запрещен по умолчанию Однако по вашему желанию вы можете открыть доступ к административной панели, либо разрешить доступ через авторизацию, таким образом вы сможете управлять сервером с удаленного компьютера.

3.3. Компоненты сервера приложений

 1) Веб-сервер Apache 2.0:

Apache - это мощный, удобный и функциональный веб-сервер (HTTP-сервер), который служит для обработки HTTP-запросов. Веб-сервер Apache называют самым главным сокровищем движения "Открытые программные системы". Он имеет отличные рабочие характеристики и поэтому используется более широко, чем все остальные Web-серверы вместе взятые. В настоящий момент около 68 процентов всех Web-узлов в мире созданы с использованием веб-сервера Apache.

Конфигурация Apache определяется директивами конфигурационного файла Apache httpd.conf, который находится в директории /usr/local/Apache/conf/ (по умолчанию для TopServer).

В целом, Apache в TopServer был специально оптимизирован. Были удалены компоненты, необходимость в которых отсутствует для большинства задач.

Файл конфигурации Apache в TopServer несколько переработан, комментарии к директивам переведены на русский язык, удалены неактуальные определения и описания, параметры директив приведены в соответствие с назначением TopServer-а.

Ответы на типичные вопросы по Apache Вы можете найти в соответствующей категории FAQ.

 2) Интерпретатор языка PHP5:

PHP - это скриптовый язык, который может быть встроен в HTML, исполняемый на стороне сервера. Синтаксис языка в большинстве заимствован из C, Java и Perl c добавлением нескольких специфичных для PHP особенностей. Цель языка - позволить веб-разработчикам легко создавать динамически генерируемые страницы.

Конфигурационным файлом PHP является файл php.ini. Он расположен в директории (по умолчанию):

/usr/local/Apache/bin/

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

Последняя версия пакета TopServer содержит одну из последних стабильных версий ядра PHP5, а также наиболее актуальные библиотеки PECL.

Ответы на типичные вопросы по PHP Вы можете найти в соответствующей категории FAQ.

 3) Интерпретатор языка PERL5:

PERL - это качественный универсальный язык серверных сценариев, позволяющий создавать мощные скрипты самой различной направленности. В TopServer используется ActiveState Perl.

 а) Путь к интерпретатору PERL в TopServer стандартный (начиная с TopServer 2.0):

#!/usr/bin/perl

 б) Скрипты PERL являются CGI-приложениями. Вы должны запускать их в директориях /cgi-bin (или в их поддиректориях).

Однако, если Вы хотите запусткать скрипты PERL в какой-либо другой директории, то используйте файл .htaccess, расположив его в той директории, где вам необходимо исполнять ваши PERL скрипты. Содержание файла .htaccess должно быть таким:

Options ExecCGI

 в) В серверном пакете TopServer интерпретатор PERL установлен лишь с основными библиотеками поддержки (*.pm). Как правило, некоторые скрипты используют специфические библиотеки, поэтому Вы можете получать ошибки сервера 500 (Internal Server Error) при попытке Ваших скриптов PERL обратиться к неустановленным библиотекам PERL.

Для того, чтобы эту проблему решить, вам необходимо установить дополнительные библиотеки PERL в TopServer.

Ответы на типичные вопросы по Perl Вы можете найти в соответствующей категории FAQ.

 4) Сервер баз данных MySQL5:

MySQL - это система управления реляционными базами данных. MySQL является очень быстрой, надежной, легкой в использовании и при этом свободно распространяемой (бесплатной) системой управления базами данных. Использование MySQL совместно с Apache и PHP стало особенно популярным по вполне объективным причинам.

 а) Взаимодействие MySQL с PHP осуществляется через сетевой интерфейс. Для того, чтобы PHP мог "общаться" с MySQL, для PHP5 существуют API библиотеки (коннекторы) для MySQL, так как PHP5 более не поддерживает MySQL по умолчанию. Все необходымые библиотеки API для MySQL, конечно, присутствуют в TopServer по умолчанию;

 б) В TopServer используется сервер баз данных MySQL версии 5, причем расширенного типа: MySQL 5.0.18-nt-max;

 в) В TopServer доступен один из лучших инструментов администрирования MySQL - phpMyAdmin. С помощью phpMyAdmin Вы сможете делать с базами данных MySQL все что угодно. Вы можете создавать новые базы данных, получать различную информацию о базах данных, добавлять, редактировать и удалять поля и записи в таблицах, добавлять, модифицировать и удалять сами таблицы, удалять сами базы данных MySQL, редактировать привилегии, экспортировать и импортировать базы данных и многое другое. phpMyAdmin достпен по локальному адресу: http://localhost/admin/mysql/phpmyadmin/.

Как необходимое дополнение, доступна удобная утилита, которая позволит вам создавать базы данных и пользователей MySQL, она также доступна по локальному адресу: http://localhost/admin/mysql/adduser/

 г) Рекомендации по взаимодействию с сервером баз данных MySQL.

Подключаться к MySQL и взаимодействовать с ней вам лучше от имени пользователя, которого Вы можете создать при создании новых баз данных. Для каждой создаваемой базы данных MySQL можно создать своего пользователя. В этом вам поможет упоминавшийся выше скрипт, доступный по адресу http://localhost/admin/mysql/adduser/.

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

(!) Пароль для пользователя root пустой, то есть без пароля (используется Host="localhost", User="root", Password="").

 д) MySQL в TopServer сконфигурирован таким образом, что кроме Вас к вашей MySQL никто подключиться не сможет, так как удаленный доступ к MySQL запрещен.

Ответы на типичные вопросы по MySQL Вы можете найти в соответствующей категории FAQ.

 5) Сервер баз данных SQLite:

SQLite - это встраиваемая система управления базами данных. Основное отличие SQLite от MySQL в том, что SQLite не является клиентской библиотекой, подключающейся к серверу баз данных. SQLite напрямую работает с файлами баз данных на жестком диске. Такой подход позволяет увеличить производительность, поскольку SQLite работает с таблицами напрямую, а не через сетевые сокеты, как MySQL.

Для PHP SQLite реализован в виде одной библиотеки PECL, а базы данных физически располагаются в тех директориях, которые выбирает пользователь в скриптах PHP при работе с SQLite. Работа с SQLite проста и эффективна и вопросов, как правило, не вызывает. В TopServer доступна система SQLiteManager, предназначена для администрирования баз данных SQLite.

 6) FTP сервер SlimFTPd:

SlimFTPd - полностью мультипоточный FTP сервер, соответствующий стандартам, предназначенный для работы на системах Windows 98 / ME или Windows NT/2K/XP. SlimFTPd полностью поддерживает стандартные команды FTP, обладает передовой виртуальной файловой системой. Объем самого SlimFTPd весьма мал и составляет около 80 кб (!). SlimFTPd написан в чистом Win32 C++ без внешних условий.

SlimFTPd использует собственный файл конфигурации для определений параметров. Формат конфигурационного файла SlimFTPd подобен формату конфигурационного файла веб-сервера Apache. Управление SlimFTPd осуществляется с помощью системы администрирования PHPsFTPd, которая доступна из панели администрирования TopServer.

SlimFTPd поддерживает пассивный способ передачи и позволяет возобновлять неудавшиеся транзакции и использует малый объем памяти. Поддерживаются следующие стандартные команды: ABOR, APPE, CDUP/XCUP, CWD/XCWD, DELE, HELP, LIST, MKD/XMKD, NOOP, PASS, PASV, PORT, PWD/XPWD, QUIT, REIN, RETR, RMD/XRMD, RNFR/RNTO, STAT, STOR, SYST, TYPE, USER. Поддерживаются следующие внедренные FTP команды: MDTM, NLST, REST, SIZE. Поддерживается установка timestamps. Соответствует стандартам RFC 959 и RFC 1123.

(!) По умолчанию в TopServer создан один FTP аккаунт и доступен по адресу ftp://localhost с параметрами авторизации:

» Имя пользователя: root;

» Пароль: admin.

Для аккаунта root разрешены все действия (ALL) и FTP сервер доступен удаленно. Поэтому, во избежание несанкционированного удаленного доступа к вашему FTP серверу, рекомендуется сменить пароль для аккаунта root (для этой цели воспользуйтесь PHPsFTPd, доступным по адресу http://localhost/admin/phpsftpd/).

4. Примечания

4.1. Устранение возможных проблем и решение вопросов

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

» Во-первых, внимательно ознакомьтесь с FAQ на TopServer, так как на большинство вопросов, касающихся работы сервера, уже даны ответы в FAQ.

» Во-вторых, Вы можете обсудить волнующие Вас вопросы на форуме, посвященном TopServer.

» В-третьих, Вы можете задать вопрос автору TopServer, обратившись с вопросом через систему обратной связи с автором.

И все-таки будем надеяться на то, что проблемы, связанные с TopServer обойдут Вас стороной.

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

4.2. Ссылки на ресурсы

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

httpd.apache.org - официальный сайт Apache HTTP Server

www.php.net - официальный сайт разработчиков PHP

www.mysql.com - официальный сайт MySQL AB

www.activestate.com - официальный сайт ActiveState, Inc. (PERL)

www.sqlite.org - официальный сайт проекта SQLite

Множество полезной информации по языку PHP и СУБД MySQL Вы можете найти на портале PHP.SU

4.3. Благодарности

Как автор и администратор проекта TopServer, хочу выразить свою благодарность всем пользователям TopServer и особенно всем тем, кто оказал моральную и (или) финансовую поддержку проекту. Большое спасибо вам!

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

С уважением, Артем Муругов (автор и администратор проекта TopServer).