Отправляем SMS.ru с удобством

02-08-2010

Было дело, проскакивала на хабре статься о сервисе sms.ru Попробовал, работает. Понравилось. Тогда на этом дело и закончилось. Но вот недавно потребовалось мне сделать отправку SMS подписавшимся клиентам. API на сайте сервиса хорошо документирован и приведены примеры, но не хватает удобства использования. В результате написал небольшой класс для взаимодействия с sms.ru.

 

Copy Source | Copy HTML

2.  
3. /**
    * Класс взаимодействия с сервисом sms.ru
    */
4. class Z_Service_Sms {
5.  
6.     protected $_apiId = NULL;
7.     protected $_responseCode = NULL;
8.     protected $_lastAction = NULL;
9.  
10.     const HOST = 'http://sms.ru/';
11.     const SEND = 'sms/send?';
12.     const STATUS = 'sms/status?';
13.     const BALANCE = 'my/balance?';
14.     const LIMIT = 'my/limit?';
15.  
16.     protected $_responseCodeTranstale = array(
17.         'send' => array(
18.             '100' => 'Сообщение принято к отправке',
19.             '200' => 'Неправильный api_id',
20.             '201' => 'Не хватает средств на лицевом счету',
21.             '202' => 'Неправильно указан получатель',
22.             '203' => 'Нет текста сообщения',
23.             '204' => 'Имя отправителя не согласовано с администрацией',
24.             '205' => 'Сообщение слишком длинное (превышает 5 СМС)',
25.             '206' => 'Превышен дневной лимит на отправку сообщений',
26.             '207' => 'На этот номер нельзя отправлять сообщения',
27.             '208' => 'Параметр time указан неправильно',
28.             '210' => 'Используется GET, где необходимо использовать POST',
29.             '211' => 'Метод не найден',
30.             '220' => 'Сервис временно недоступен, попробуйте чуть позже.',
31.         ),
32.         'status' => array(
33.             '-1' => 'Сообщение не найдено',
34.             '100' => 'Сообщение находится в очереди',
35.             '101' => 'Сообщение передается оператору',
36.             '102' => 'Сообщение отправлено (в пути)',
37.             '103' => 'Сообщение доставлено',
38.             '104' => 'Не может быть доставлено: время жизни истекло',
39.             '105' => 'Не может быть доставлено: удалено оператором',
40.             '106' => 'Не может быть доставлено: сбой в телефоне',
41.             '107' => 'Не может быть доставлено: неизвестная причина',
42.             '108' => 'Не может быть доставлено: отклонено',
43.             '200' => 'Неправильный api_id',
44.             '210' => 'Используется GET, где необходимо использовать POST',
45.             '211' => 'Метод не найден',
46.             '220' => 'Сервис временно недоступен, попробуйте чуть позже',
47.         ),
48.         'balance' => array(
49.             '100' => 'Запрос выполнен',
50.             '200' => 'Неправильный api_id',
51.             '210' => 'Используется GET, где необходимо использовать POST',
52.             '211' => 'Метод не найден',
53.             '220' => 'Сервис временно недоступен, попробуйте чуть позже.',
54.         ),
55.         'limit' => array(
56.             '100' => 'Запрос выполнен',
57.             '200' => 'Неправильный api_id',
58.             '210' => 'Используется GET, где необходимо использовать POST',
59.             '211' => 'Метод не найден',
60.             '220' => 'Сервис временно недоступен, попробуйте чуть позже.',
61.         ),
62.     );
63.  
64.     /**
         *
         * Идентификатор api_id
         * @param string $id
         */
65.     public function __construct($id)
66.     {
67.         $this->_apiId = $id;
68.     }
69.  
70.     /**
         *
         * @param string $to телефон: 11 знаков. например 79060000000
         * @param string $text текст сообщение
         * @param string $from отправитель
         * @return string id сообщения
         */
71.     public function send($to,$text,$from=NULL)
72.     {
73.         $apiParams['api_id'] = $this->_apiId;
74.         $apiParams['to'] = $to;
75.         $apiParams['text'] = $text;
76.         if ($from)
77.             $apiParams['from'] = $from;
78.         $url = self::HOST.self::SEND.http_build_query($apiParams);;
79.         $body = file_get_contents($url);
80.         @list($code,$smsId) = explode("\n", $body);
81.         $this->_lastAction = 'send';
82.         $this->_responseCode = $code;
83.         return $smsId;
84.     }
85.  
86.     /**
         *
         * @param string $id id сообщения
         * @return string код статуса сообщения.
         */
87.     public function status($id)
88.     {
89.         $apiParams['api_id'] = $this->_apiId;
90.         $apiParams['id'] = $id;
91.         $url = self::HOST.self::STATUS.http_build_query($apiParams);
92.         $body = file_get_contents($url);
93.         $status = $body;
94.         $this->_lastAction = 'status';
95.         $this->_responseCode = $status;
96.         return $status;
97.     }
98.  
99.     /**
         *
         * @return string Баланс в рублях
         */
100.     public function balance()
101.     {
102.         $apiParams['api_id'] = $this->_apiId;
103.         $url = self::HOST.self::BALANCE.http_build_query($apiParams);
104.         $body = file_get_contents($url);
105.         @list($code,$balance) = explode("\n", $body);
106.         $this->_lastAction = 'balance';
107.         $this->_responseCode = $code;
108.         return $balance;
109.     }
110.  
111.     /**
          *
          * @return int количество оставшихся сообщений
          */
112.     public function limit()
113.     {
114.         $apiParams['api_id'] = $this->_apiId;
115.         $url = self::HOST.self::LIMIT.http_build_query($apiParams);
116.         $body = file_get_contents($url);
117.         @list($code,$count,$limit) = explode("\n", $body);
118.         $this->_lastAction = 'limit';
119.         $this->_responseCode = $code;
120.         return (int)($count - $limit);
121.     }
122.  
123.  
124.     /**
          *
          * @return string код результата выполнения последней операции
          */
125.     public function getResponseCode()
126.     {
127.         return $this->_responseCode;
128.     }
129.  
130.     /**
          *
          * @return string расшифровка кода результата выполнения последней операции
          */
131.     public function getResponseMessage()
132.     {
133.         if ($this->_lastAction)
134.             return $this->_responseCodeTranstale[$this->_lastAction][$this->getResponseCode()];
135.         else
136.             return 'Нет данных для возврата сообщения';
137.     }
138.  
139. }
140.  

Прошу пользоваться и давать советы по улучшению.

Вернуться в блог
Warning: count(): Parameter must be an array or an object that implements Countable in /var/www/cramen.ru/library/Zend/Db/Table/Abstract.php on line 1259