php soap установка linux
Установка PHP Soap на CentOS
SOAP (Simple Object Access Protocol) — представляет собой простой протокол основанный на XML, позволяет обмениваться информацией между распределенными приложениями. На практике может использоваться для разных задач. Одни из популярных это интеграция приложений с внешними службами. В моем случае потребовалось интегрировать веб-приложение системой 1C, для получения актуальной информации в режиме реального времени из базы данных 1C по запросу пользователя на сайте. На самом деле SOAP умеет работать с множеством протоколов прикладного уровня, среди которых SMTP, FTP, HTTP, HTTPS, а так же др. На первых порах SOAP главным образом предназначался для реализации удаленного вызова процедур, или как его ещё сокращенно именуют RPC. Сегодня он используется произвольно, для обмена данными в формате XML.
Базовая конфигурация PHP обычно не включает в себе такие модули, и при попытке обращаться к специализированным классам для работы с SOAP сервером, приходилось наблюдать сообщение об ошибке, что-то вроде этого:
Fatal error: Class ‘SoapClient’ not found
Это уже пол дела, так как мы уже знаем, что у нас нету класса SoapClient. Чтобы это дело заработало, необходимо к интерпретатору PHP прикрутить модуль Soap Client, который собственно и даст возможность работать с SOAP.
Тут вам потребуется доступ с правами root на сервер, чтобы сделать нужные операции. Если вы пользуетесь хостингом, где у вас нет таких полномочий, то попросите администраторов хостинга, скорее всего им не составит большого труда выполнить эти операции.
В моем же случае использовалась система CentOS. На ней установлена традиционная связка LAMP, которую можно повстречать на многих других веб-серверах. Установка простая, и типична для систем CentOS Linux. Итак, мы авторизовались в системе под root, далее посредством менеджера пакетов YUM мы будем устанавливать php soap.
Устанавливаем пакет php soap
После выполнения команды вам будет показана информация о пакете, который планируется установить в систему, и вас так же попросят подтвердить начало установки:
После ввода команды «y», а это говорит о том, что вы подтверждаете установку, начнется процедура скачивания и установки пакета из репозитория. После установки php soap необходимо так же перезапустить веб сервер, в нашем случае это httpd. Это позволит веб-серверу подгрузить изменения в конфигурации.
Перезагружаем веб-сервер httpd
Теперь можно проверить наличие нужного нам компонента для работы с SOAP, чтобы убедиться, что он установлен.
Проверяем наличие SOAP в PHP
В результате выполнения команды, вы должны увидеть строку с надписью «soap», это говорит о том, что он уже есть. Кроме того проверить его наличие так же можно выполнив обращения к классу модуля из самих скриптов, если это не затруднительно, если скрипты отрабатывают, то это означает что библиотека установлена.
Работа с веб-серверами на php посредством SOAP
Не буду останавливаться на вопросе, что такое веб-сервисы и зачем они нужны. В сети очень много статей на эту тему. Просто постараюсь вкратце показать, каким простым способом возможно создание клиента к любому веб-сервису на php.
Для использования SOAP в php необходимо подключить модуль SOAP (входит в дистрибутив php5). Под windows это делается просто – необходимо дописать (именно дописать, так как эта строка там не просто закомментирована, она отсутствует вообще) в php.ini:
extension=php_soap.dll
Не забудьте перезапустить сервер, если php у вас установлен как модуль.
Создание SOAP-клиента по WSDL-документу
Создание SOAP-клиента обычно происходит по WSDL-документу, который представляет собой XML-документ в определенном формате, полностью описывающий тот или иной веб-сервис. За подробностями по поводу WSDL – отправляю Вас на сайт консорциума W3C — www.w3.org/TR/2005/WD-wsdl20-soap11-binding-20050510.
Главное же, что необходимо знать для того, чтобы построить клиента к веб-сервису – это знать URL его WSDL-документа.
Для примера возьмем веб-сервис «Currency Exchange Rate» от xmethods.com. Адрес этого веб-сервиса, который позволяет получать курсы валют в режиме онлайн — www.xmethods.net/sd/2001/CurrencyExchangeService.wsdl.
Второй важный момент – из описания веб-сервиса необходимо получить информацию о том, какие методы этот сервис предоставляет, и какие параметры мы должны передавать ему в качестве входных значений (очень похоже на вызов обычной функции php или метода класса). Обычно эта информация содержится в описании сервиса на его сайте. Наш веб-сервис для получения курса валют предоставляет метод getRate(), которому в качестве аргументов передаются коды валют.
И последнее – важно знать, что ожидать в качестве ответа: сколько значений, какого типа и т.п. Это также можно получить из описания.
А в результате код получается очень простым и компактным, почти элементарным:
Как видно из кода в конструктор класса SoapClient необходимо передать URL WSDL-документа и получить объект для работы с нужным веб-сервисом. Затем вызывается метод этого объекта, имя которого совпадает с именем самого метода веб-сервиса. Возвращает же этот метод желаемый нами результат.
Итак, этот простой пример иллюстрирует нам принцип построения SOAP-клиента для веб-сервисов на php. Однако в реальном приложении еще о многом придется позаботиться, в частности о том, что в момент обращения к веб-сервису он может быть временно недоступен или возвращать ошибку. Явно напрашивается использование блока try/catch/throw 🙂
Как установить расширение soap?
Как установить мыло?
я получил эту ошибку:
фатальная ошибка: класс ‘SoapClient’ не найден в /home/user/mysite.com/path/to/file.php на линии 16
Я размещаю свой сайт в DreamHost, и они не поддерживают стороннюю установку.
Я скопировал php.ini-файл с этим скриптом: http://sxi.sabrextreme.com/dh-phpini
Я использую API с веб-сайта, и он говорит что-то вроде это:
и вот список расширений моего php.файла ini:
проблема, расширение php_soap.dll там не найден.
6 ответов
Для Windows
1: Найти расширения=php_soap.dll файлы в php.ini и удалите точку с запятой(;)
2: перезагрузите сервер
Для Linux (Ubuntu)
на ubuntu установить php_soap on PHP7 использовать ниже команды. ссылка
для более старой версии php используйте команду ниже и перезапустите apache.
Dreamhost теперь включает SoapClient в свои сборки PHP 5.3. Вы можете переключить свою версию php в разделе настройки домена панели управления dreamhost.
У меня была та же проблема, не было расширения=php_soap.dll в моем php.Ини Но это было потому, что я скопировал php.ini из старой и предыдущей версии php (не очень хорошая идея). Я нашел dll в каталоге ext, поэтому я просто мог поместить его сам в php.Ини расширение=php_soap.файл DLL После перезапуска Apache все работали с soap:)
Они не поддерживают его, как в они не помогут вам или будут нести ответственность за вас, но вы можете установить пользовательские расширения. Для этого вам нужно сначала настройка локальной установки php 5, во время этого процесса вы можете компилировать необходимые расширения или динамически добавлять их в php.ini после того.
найдите эту строку в php.ini:
затем удалите точку с запятой ; и перезапустите сервер Apache
Взаимодействие php-soap на linux с авторизацией по сертификатам с использованием алгоритмов ГОСТ
С криптографией я сталкивался ранее, приходилось разворачивать удостоверяющий центр на КриптоПро в свое время, так что общие представления о том что такое закрытые и открытые ключи и сертификаты у меня имелось, но вот о том как все это работает в Linux представления особого не было.
Встала задача обеспечить взаимодействие со службами РосМинздрава, а именно — с федеральным регистром медработников по протоколу SOAP. Со стороны клиента система на CentOS и работающими службами на PHP, со стороны сервера — SOAP-сервис с авторизацией по сертификатам с использованием ГОСТ алгоритмов. В наличии была флешка с закрытым ключом, сформированным удостоверяющим центром РосМинздрава и сертификат этого ключа.
После анализа ситуации по использованию ГОСТ алгоритмов шифрования в мире Linux выяснено что за последние годы здесь есть хорошее движение вперед, но все таки не совсем все хорошо. Итак, для того чтобы заставить расширение php-soap прозрачно понимать алгоритмы ГОСТ, а также использовать сертификаты и ключи выданные РосМинздравом нужно сделать следующее:
1. Обновить в дистрибутиве библиотеку OpenSSL до версии не ниже 1.0.1с и настроить поддержку ГОСТ.
2. Преобразовать выданный ключ и сертификат в формат, понятный OpenSSL. Проверить работу OpenSSL.
3. Подправить расширение OpenSSL в PHP и перекомпилировать сам PHP. Протестировать работу SOAP на PHP.
Итак, приступим. Данные дистрибутива, установленного php и библиотеки openssl:
Обновление библиотеки OpenSSL
Метод собирать «из исходников» и засорять систему — не наш метод. Поэтому лучший вариант — найти готовый пакет, и я его нашел в репозитории axivo:
Проверяем установленную версию OpenSSL:
и в самый конец файла:
После внесенных изменений проверяем, видит ли OpenSSL алгоритмы ГОСТ:
Преобразуем выданный ключ и сертификат в формат, понятный OpenSSL
Для этого нам понадобится Windows машина с установленным CryptoPRO CSP 3.6. Я его слил с сайта разработчика (там дается демонстрационный режим режим на 3 месяца).
Первое что делаем — экспортируем ключевой контейнер в реестр средствами КриптоПро. Для этого открываем КриптоПро из панели управления Windows. Вставляем наш ключевой носитель в компьютер. Для обычной флешки убеждаемся, что у нас среди считывателей на вкладке «Оборудование» есть «Все съемные диски» и «Реестр». Если у вас не обычная флешка а что-то типа РуТокен либо Etoken либо другой носитель — необходимо наличие его драйверов и библиотеки для использования в КриптоПро (Его должно быть видно в разделе «Настроить Считыватели» на той же вкладке).
Далее переходим на вкладку «Сервис» и нажимаем «Копировать», нажимаем «Обзор» и выбираем среди списка свой ключевой контейнер. Если его там вдруг не находим — то возвращаемся к предыдущему параграфу и все проверяем. Далее вводим осмысленное имя нового ключевого контейнера, нажимаем «Готово» и в качестве носителя в появившемся окне выбираем «Реестр». Новый пароль на контейнер не ставим.
Теперь нам нужно установить сертификат в новый контейнер. На вкладке «Сервис» в КриптоПро нажимаем кнопку «Установить личный Сертификат», указываем файл с нашим сертификатом, нажимаем «Далее», выбираем только что созданный нами контейнер и не забываем галочку «Установить сертификат в контейнер».
Для того чтобы экспортировать данный сертификат в формате PKSC#12 вместе с закрытым ключом — нам понадобится сторонняя утилита. Которую можно либо купить здесь либо найти на просторах интернета по имени p12fromgostcsp. Запускаем данную утилиту, выбираем наш сертификат, пароль оставляем пустым и сохраняем его в файл mycert.p12.
Копируем полученный сертификат на linux-машину. Проверяем, что в сертификате у нас есть оба ключа — закрытый и открытый:
На запрос пароля просто нажимаем Enter. И смотрим наличие строк BEGIN CERTIFICATE и BEGIN PRIVATE KEY. Если строки есть то все в порядке. Преобразуем полученный сертификат в формат PEM:
Если вам нужна не только авторизация по клиентскому сертификату, но и также проверка валидности самого сервера — вам понадобится корневой сертификат удостоверяющего центра. Его можно просто через Windows открыть и сохранить в формате DER в кодировке X.509 (Со вкладки «Состав» при просмотре сертификата), так как закрытого ключа он не содержит. Затем преобразовать его в PEM формат через OpenSSL.
Где cacert.cer — имя исходного файла с корневым сертификатом. Проверить коннект с сервером с использованием сертификатов можно через OpenSSL командой:
В итоге, если все сделано верно, у вас должен получится вот такой вывод в конце:
Правка и перекомпиляция PHP
Основная проблема заключается в том, что для того чтобы OpenSSL использовала файл конфигурации по умолчанию (именно там у нас прописаны настройки для алгоритмов ГОСТ) перед ее использованием необходимо вызвать функцию OPENSSL_config(NULL). В расширении PHP OpenSSL этого не сделано, поэтому модуль PHP-SOAP при использовании SSL-соединения не видит алгоритмов ГОСТ. Кстати, тоже самое касается и других библиотек, например curl. Ее тоже нужно патчить если вы собираетесь с ней работать.
Итак приступим. Для того чтобы нам поправить OpenSSL необходимо перекомпилировать весь PHP, так как в CentOS расширение OpenSSL сделано не модулем.
Подготавливаем среду для сборки пакетов:
Качаем исходники PHP и устанавливаем их:
Переходим в папку SOURCES и извлекаем php, делаем копию папки с иходниками:
В результате получится файл со следующим содержимым:
Теперь нужно заставить сборщик использовать наш патч. Правила сборки описаны в файле SPEC/php.spec. Открываем его и после строки описания патчей (у меня это строка начинающаяся на Patch230) вставляем строку с описанием нового патча:
Также прописываем вызов данного патча перед сборкой, для этого ищем строки начинающиеся на %patch и в конце них прописываем
Сохраняем файл. Перед сборкой пакета ставим все зависимости для сборки:
Далее приступаем к сборке, из папки rpmbuld запускаем команду:
Сборка занимает продолжительное время, и в случае если все прошло хорошо, в папке RPMS/ <Ваша_архитектура>появятся готовые rpm_пакеты.
Для архитектуры x86_64:
Теперь можем установить все это «добро» поверх уже установленного php с заменой:
Далее проверяем работу php-soap. Для примера можно использовать такой код (пример для сервиса «Федеральный регистр медработников»):
Если все прошло успешно никаких ошибок не возникнет и PHP-SOAP без проблем заработает.
Далее если необходимо можно также подправить библиотеку curl, сделать проверку сертификата сервера и вообще все операции которые допустимы для SSL-соединений вплоть до поднятия своего веб сервера с авторизацией по сертификатам с алгоритмами ГОСТ.
Использование SOAP в PHP
Рассмотрим пример, как использовать SOAP в PHP. Использование SOAP в PHP может показаться трудным, и неудобным, однако немного разобравшись, вы сразу же поймете что это не так. Если у вас возникла необходимость воспользоваться протоколом SOAP, то данный пример вам будет в помощь.
Перед использованием классов SOAP библиотека должна быть предварительно подключена в PHP. Как установить PHP Soap на сервер CentOS Linux ранее уже был пост об этом. Приступим непосредственно к примеру.
В нашем примере есть некий удаленный сервер SOAP, к которому мы будем обращаться с нашего PHP — скрипта. Нам необходимо заполучить какие-либо данные, со стороны сервера SOAP. Традиционно SOAP предназначался для реализации RPC (удаленный вызов процедур). Это говорит о том, что чтобы получить какие-то данные, на другой стороне мы будем иметь дело с чем-то вроде функции, к которой будем обращаться по имени, отправляя предустановленные параметры. В качестве успешного выполнения мы будем получать данные в виде объекта. С объектами мы так же можем привычно работать в PHP, что весьма удобно.
Как видно из примера ничего космического. Сперва мы подключаемся к серверу, для этого при создании объекта класса SoapClient мы передаем три параметра: URL сервера, логин и пароль. Далее обращаемся к функции, в нашем случае она называется GetOrderInfo, именоваться она может как угодно, и принимать различные параметры. Находиться данная функция на стороне SOAP сервера. В примере мы передаем на сервер код, по которому нам должен вернуться объект с данными. Далее мы просто выводим эти данные. Этот пример прост, и он больше для демонстрации обмена данными между PHP-скриптом и SOAP сервером. В действительности объемы отправляемых параметром, и принимаемых данных может быть значительно больше, но это уже дело архитектурной сложности системы, и у каждого она своя.