fotografde / cakephp-sms
SMS Plugin for CakePHP
Installs: 73 218
Dependents: 0
Suggesters: 0
Security: 0
Stars: 12
Watchers: 15
Forks: 3
Open Issues: 1
Type:cakephp-plugin
Requires
- php: >=5.4
- cakephp/cakephp: >=2.6
- composer/installers: *
Suggests
- xi/sms: >=0.2.2
This package is auto-updated.
Last update: 2024-10-23 15:08:40 UTC
README
Send SMS with CakePHP.
Usage
App::uses('CakeSms', 'Sms.Network/Sms'); $CakeSms = new CakeSms('default'); $CakeSms->to('+491234567890'); $CakeSms->from('+841234567890'); $CakeSms->send('Hello world!');
Installation via Composer
"require": { "fotografde/cakephp-sms": ">=1.0.0" }
Configuration
Load plugin in Config/bootstrap.php
CakePlugin::load('Sms');
Create Config/sms.php
class SmsConfig { public $default = array( 'transport' => 'Clickatell', // will use class ClickatellSmsTransport ); }
Implement a transport class under Lib/Network/Sms/. We recommend implementing Xi SMS, this way for example:
/** * Send SMS through SMS provider Clickatell */ use Xi\Sms\Gateway\ClickatellGateway; App::uses('AbstractSmsTransport', 'Sms.Network/Sms'); class ClickatellSmsTransport extends AbstractSmsTransport { const CLICKATELL_API_ID = 'XXXX'; const CLICKATELL_USER = 'YYYY'; const CLICKATELL_PASSWORD = 'ZZZZ'; /** * Sends an SMS Through Clickatell * We could also consider using this library: http://github.com/arcturial/clickatell * * @param CakeSms $sms * @return bool Success */ public function send(CakeSms $sms) { $gw = new ClickatellGateway( self::CLICKATELL_API_ID, self::CLICKATELL_USER, self::CLICKATELL_PASSWORD ); $service = new Xi\Sms\SmsService($gw); $msg = new Xi\Sms\SmsMessage( $sms->message(), self::parsePhoneNumber($sms->from()), self::parsePhoneNumber($sms->to()) ); $response = $service->send($msg); return !empty($response); } /** * Parses a phone number to fit Clickatell requirements * from +49123[...] to 49123[...] * * @param array|string $phoneNumber * @return array|string|bool */ public static function parsePhoneNumber($phoneNumber) { if (is_array($phoneNumber)) { return array_map('self::parsePhoneNumber', $phoneNumber); } if (preg_match('/^\+([0-9]+)$/', (string) $phoneNumber, $matches)) { return $matches[1]; } return false; } }