Download the PHP package rockandscissor/clockworksms without Composer
On this page you can find all versions of the php package rockandscissor/clockworksms. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download rockandscissor/clockworksms
More information about rockandscissor/clockworksms
Files in rockandscissor/clockworksms
Package clockworksms
Short Description ClockworkSMS, International SMS API
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package clockworksms
Clockwork SMS API Wrapper for PHP
This wrapper lets you interact with Clockwork without the hassle of having to create any XML or make HTTP calls. This version of the wrapper has been forked and updated to work with newer versions of PHP by Rock & Scissor as Mediaburst was acquired by Textanywhere which means the original repo was abandoned. We intend to keep this package up to date as long as the API is still supported by Textanywhere.
What's Clockwork?
Clockwork is Mediaburst's SMS API.
Prerequisites
- A Clockwork account
Usage
Installing with composer
The easiest way to get Clockwork is to use Composer to automatically download and include it in your project. Setup Composer and add us to your composer.json
If you are using your own autoloader we are using the PSR-4 namespacing scheme.
Including directly
Download the Clockwork library, put it in your project and require the Clockwork class and the ClockworkException classes:
Sending a message
Sending multiple messages
We recommend you use batch sizes of 500 messages or fewer. By limiting the batch size it prevents any timeouts when sending.
Handling the response
The responses come back as arrays, these contain the unique Clockwork message ID, whether the message worked (success), and the original SMS so you can update your database.
Array
(
[id] => VE_164732148
[success] => 1
[sms] => Array
(
[to] => 441234567891
[message] => This is a test!
)
)If you send multiple SMS messages in a single send, you'll get back an array of results, one per SMS.
The result will look something like this:
Array
(
[0] => Array
(
[id] => VI_143228951
[success] => 1
[sms] => Array
(
[to] => 441234567891
[message] => This is a test!
)
)
[1] => Array
(
[id] => VI_143228952
[success] => 1
[sms] => Array
(
[to] => 441234567892
[message] => This is a test 2!
)
)
)If a message fails, the reason for failure will be set in error_code and error_message.
For example, if you send to invalid phone number "abc":
Array
(
[error_code] => 10
[error_message] => Invalid 'To' Parameter
[success] => 0
[sms] => Array
(
[to] => abc
[message] => This is a test!
)
)Checking your balance
Check your available SMS balance:
This will return:
Array
(
[symbol] => £
[balance] => 351.91
[code] => GBP
[account_type] => PAYG
)Account Type can be either PAYG or Invoice.
Handling Errors
The Clockwork wrapper will throw a ClockworkException if the entire call failed.
Advanced Usage
This class has a few additional features that some users may find useful, if these are not set your account defaults will be used.
Optional Parameters
See the Clockwork Documentation for full details on these options.
-
$from [string]
The from address displayed on a phone when they receive a message
-
$long [boolean]
Enable long SMS. A standard text can contain 160 characters, a long SMS supports up to 459.
-
$truncate [nullable boolean]
Truncate the message payload if it is too long, if this is set to false, the message will fail if it is too long.
-
$invalid_char_action [string]
What to do if the message contains an invalid character. Possible values are
- error - Fail the message
- remove - Remove the invalid characters then send
- replace - Replace some common invalid characters such as replacing curved quotes with straight quotes
-
$ssl [boolean, default: true]
Use SSL when making an HTTP request to the Clockwork API
Setting Options
Global Options
Options set on the API object will apply to all SMS messages unless specifically overridden.
In this example both messages will be sent from Clockwork:
Per-message Options
Set option values individually on each message.
In this example, one message will be from Clockwork and the other from 84433:
SSL Errors
Due to the huge variety of PHP setups out there a small proportion of users may get PHP errors when making API calls due to their SSL configuration.
The errors will generally look something like this:
If you're seeing this error there are two fixes available, the first is easy, simply disable SSL on Clockwork calls. Alternatively you can setup your PHP install with the correct root certificates.
Disable SSL on Clockwork calls
Setup SSL root certificates on your server
This is much more complicated as it depends on your setup, however there are many guides available online. Try a search term like "windows php curl root certificates" or "ubuntu update root certificates".
License
This project is licensed under the MIT open-source license.
A copy of this license can be found in license.txt.
Contributing
If you have any feedback on this wrapper drop us an email to [email protected].
The project is hosted on GitHub at https://github.com/mediaburst/clockwork-php. If you would like to contribute a bug fix or improvement please fork the project and submit a pull request.
