- Configuring your PEAR setup
- Config options
- Установка модулей PEAR
- Использование PEAR с PHP 7.0 и новее
- Предварительная настройка
- Установка модулей
- Указание пути до папки c модулями в include_path
- Использование PEAR с PHP 5.6
- Предварительная настройка
- Установка модулей
- Указание пути до папки с модулями в include_path
- Установка PEAR под Windows
Configuring your PEAR setup
The default settings suffice for novice users, there is rarely a need to change them when getting started. You can go on with installing packages.
Reading single values is accomplished by using config-get . The following command will show you where all the .php files of your installed pear packages reside.
$ pear config-get php_dir /usr/share/pear
Changing a value is as easy as retrieving it:
$ pear config-set preferred_state beta config-set succeeded
When changing a config setting, it does not immediately get applied to already installed packages. This is especially true when changing variables like data_dir . Use $ pear upgrade —force to reinstall all packages in such cases.
Config options
Variable Name | Description | Default Value |
---|---|---|
bin_dir | Directory where executables are installed | /usr/bin |
doc_dir | Directory where documentation is installed | /usr/lib/php/docs |
ext_dir | Directory where loadable extensions are installed | ./ |
php_dir | Directory where PHP files are installed (like PEAR files) | /usr/lib/php |
cache_dir | PEAR installer cache directory, and used by XMLRPC | /tmp/pear/cache |
data_dir | Directory where data files are installed | /usr/lib/php/data |
php_bin | The PHP CLI or CGI binary for executing scripts | /usr/bin/php |
test_dir | Directory where regression tests are installed | /usr/lib/php/tests |
cache_ttk | Number of seconds that the local cache is used, and not updated (Time To Kill) | 3600 |
preferred_state | Preferred package state: stable, beta, alpha, devel, or snapshot | stable |
umask | umask used when creating files (Unix-like systems only) | 22 |
verbose | Debug log level: 0-3 where 3 is full debug mode. | 1 |
http_proxy | The optional HTTP proxy address (host:port) used when downloading packages | |
remote_config | Remote configuration file, used to mirror a local installation on a remote server through ftp. (PEAR 1.4+) | |
auto_discover | Auto-discover new channels from command line or dependencies | 0 |
default_channel | Default channel (PEAR 1.4+) | pear.php.net (pecl.php.net if using the pecl command) |
preferred_mirror | Preferred channel mirror (PEAR 1.4+) | pear.php.net (pecl.php.net if using the pecl command) |
master_server | PEAR server [deprecated in PEAR 1.4+] | pear.php.net |
password | PEAR password (used by maintainers) | |
sig_bin | Signature handling program | /sw/bin/gpg |
sig_keydir | Signature key directory | /etc/pearkeys |
sig_keyid | The key used for signing | |
sig_type | Package signature type (only gpg) | gpg |
username | PEAR username (used by maintainers) |
Установка модулей PEAR
PEAR — это репозиторий классов (модулей) языка PHP, список доступных модулей можно увидеть на её официальном сайте — https://pear.php.net/packages.php. Установка модулей из данного репозитория на виртуальном хостинге возможна через официальную утилиту командной строки pear.
На серверах виртуального хостинга по умолчанию доступна команда pear, но она работает только для версий PHP 5.2-5.6 включительно. Для установки модулей на PHP 7.0 и новее необходимо установить последнюю версию утилиты на аккаунт по инструкции ниже. Одновременная работа системной утилиты pear и утилиты, установленной локально, в рамках одного аккаунта не гарантируется.
Использование PEAR с PHP 7.0 и новее
Предварительная настройка
Перед установкой первого модуля предварительно необходимо установить последнюю версию утилиты pear, используя официальный установщик в консоли SSH в домашней директории:
На первом шаге можно выбрать все параметры по умолчанию, на втором на вопрос «Would you like to alter php.ini ? [Y/n]» необходимо ввести символ «n» (нет). На третьем шаге нужно подтвердить установку клавишей Enter.
3. Добавить путь к утилите в переменную $PATH, чтобы был доступен её запуск из любой папки на аккаунте
Добавьте в файл .profile в корне аккаунта строку вида:
Если файла .profile в корне аккаунта нет, его необходимо предварительно создать.
4. Выйти из SSH-сессии и войти заново для применения изменений в $PATH
5. Обновить данные репозитория
Установка модулей
Установка производится командой вида pear install -o . К примеру, установка пакета mail:
$ pear install -o mail Did not download optional dependencies: pear/Net_SMTP, use --alldeps to download automatically pear/Mail can optionally use package "pear/Net_SMTP" (version >= 1.10.0) downloading Mail-1.5.0.tgz . Starting to download Mail-1.5.0.tgz (23,221 bytes) . done: 23,221 bytes install ok: channel://pear.php.net/Mail-1.5.0
Указание пути до папки c модулями в include_path
Самым последним действием нужно указать сайту путь до директории, в которой хранятся классы PEAR. Для этого достаточно добавить в файл .htaccess одну строку вида:
в которую необходимо подставить данные в соответствии с вашим аккаунтом. Например, для логина testlogin директива будет выглядеть так:
Как альтернативный вариант, можно добавить указание пути к папке в начало PHP-скрипта, такой строкой:
Использование PEAR с PHP 5.6
Предварительная настройка
Перед установкой первого модуля предварительно необходимо создать файл с настройками в домашней директории такой командой по SSH (выполняется также из домашней директории):
Затем следует скопировать стандартные файлы PEAR, чтобы копия хранилась в домашнем каталоге:
Установка модулей
Установка производится командой вида PHP_PEAR_PHP_BIN=php5.6 pear install -o . К примеру, установка пакета File_Find:
$ PHP_PEAR_PHP_BIN=php5.6 pear install -o File_Find downloading File_Find-1.3.3.tgz . Starting to download File_Find-1.3.3.tgz (8,212 bytes) . done: 8,212 bytes install ok: channel://pear.php.net/File_Find-1.3.3
Указание пути до папки с модулями в include_path
Самым последним действием нужно указать сайту путь до директории, в которой хранятся классы PEAR. Для этого достаточно добавить в файл .htaccess одну строку вида:
в которую необходимо подставить данные в соответствии с вашим аккаунтом. Например, для логина testlogin директива будет выглядеть так:
Как альтернативный вариант, можно добавить указание пути к папке в начало PHP-скрипта, такой строкой:
Установка PEAR под Windows
3) После использования .bat файл ГРУША выгрузиться в явном виде в указанную вами при установке папку — по умолчанию (так было в моём случае) — это будет корень расположения php-интерпретатора — если вы выгрузили всё это хозяйство в корень — найдите файл PEAR_ENV.reg — и кликните по нему дважды — на вопрос системы о чём-то там ответьте положительно.
По идее после этого всё должно заработать — а именно запускаем командную строку виндоус нажав флажок_на_клаве+R (такую вот комбинацию клавиш) , а в появившемся окошке пишем только три буквы = cmd и жмём ок .Далее уже в консоли набираем простую команду pear если список подкоманд вроде этого =
$ pear Commands: build Build an Extension From C Source bundle Unpacks a Pecl Package channel-add Add a Channel .
не показывается , а выводится сообщение вроде =
C:\Documents and Settings\rooter>pear PHP_PEAR_PHP_BIN is not set correctly. Please fix it using your environment variable or modify the default value in pear.bat The current value is: .\php.exe
то переходим у следующему пункту =
4) Итак нам следует изменить переменную среды окружения (по-идее это действие за нас должен был выполнить PEAR_ENV.reg — но что-то пошло не так)
Например мой имел такой вид =
REGEDIT4 [HKEY_CURRENT_USER\Environment] "PHP_PEAR_SYSCONF_DIR"="C:\\php" "PHP_PEAR_INSTALL_DIR"="C:\\php\\pear" "PHP_PEAR_DOC_DIR"="C:\\php\\docs" "PHP_PEAR_BIN_DIR"="C:\\php" "PHP_PEAR_DATA_DIR"="C:\\php\\data" "PHP_PEAR_PHP_BIN"="\\php.exe" "PHP_PEAR_TEST_DIR"="C:\\php\\tests"
Консоль сообщает нам , что переменная PHP_PEAR_PHP_BIN задана неправильно —
вообще мой php-интерпретатор лежит на компе по адресу
соответственно, изменим значение переменной на такое =
"PHP_PEAR_PHP_BIN"="C:\\php\\php.exe"
можно попробовать перезапустить этот скрипт после сохранения — но у меня сейчас нет времени чтобы проверить как именно он сработает — поэтому я использую другой способ —
Совершаем такой путь =
пуск->панель управления->система->дополнительно->переменные среды->
далее у меня после запуска PEAR_ENV.reg вышеозначенные переменные разместились в разделе =
переменные среды для. (имя пользователя)
Находим там переменную PHP_PEAR_PHP_BIN жмём ИЗМЕНИТЬ и прописываем путь к вамему php.exe в моём случае это =
жмём ОК.
6) ПЕРЕЗАГРУЖАЕМ КОМПЬЮТЕР
7) снова вызываем командную строку — выполняем из любого места команду pear и любуемся результатом =
Microsoft Windows XP [Версия 5.1.2600] (С) Корпорация Майкрософт, 1985-2001. C:\Documents and Settings\rooter>pear Commands: build Build an Extension From C Source bundle Unpacks a Pecl Package channel-add Add a Channel channel-alias Specify an alias to a channel name channel-delete Remove a Channel From the List channel-discover Initialize a Channel from its server channel-info Retrieve Information on a Channel channel-login Connects and authenticates to remote channel server channel-logout Logs out from the remote channel server channel-update Update an Existing Channel clear-cache Clear Web Services Cache config-create Create a Default configuration file config-get Show One Setting config-help Show Information About Setting config-set Change Setting config-show Show All Settings convert Convert a package.xml 1.0 to package.xml 2.0 format cvsdiff Run a "cvs diff" for all files in a package cvstag Set CVS Release Tag download Download Package download-all Downloads each available package from the default channel info Display information about a package install Install Package list List Installed Packages In The Default Channel list-all List All Packages list-channels List Available Channels list-files List Files In Installed Package list-upgrades List Available Upgrades login Connects and authenticates to remote server [Deprecated i n favor of channel-login] logout Logs out from the remote server [Deprecated in favor of c hannel-logout] makerpm Builds an RPM spec file from a PEAR package package Build Package package-dependencies Show package dependencies package-validate Validate Package Consistency pickle Build PECL Package remote-info Information About Remote Packages remote-list List Remote Packages run-scripts Run Post-Install Scripts bundled with a package run-tests Run Regression Tests search Search remote package database shell-test Shell Script Test sign Sign a package distribution file svntag Set SVN Release Tag uninstall Un-install Package update-channels Update the Channel List upgrade Upgrade Package upgrade-all Upgrade All Packages [Deprecated in favor of calling upgr ade with no parameters] Usage: pear [options] command [command-options] Type "pear help options" to list all options. Type "pear help shortcuts" to list all command shortcuts. Type "pear help " to get the help for the specified command.
8) если вы получили этот список команд при исполнении вышеозначенной команды — то значит всё ОК )))
9) жалко не успеваю поэксперементировать с PEAR_ENV.reg. что-то через него сразу не получилось.
____________________________
Источники(читать подробнее)=
http://pear.php.net/manual/en/installati.