README

This small PHP program sends SMS messages using a GOIP GSM Gateway. The messages are received through line command.

This is a standalone code snippet from a larger software project.

GOIP documentation (doc/goip_sms_Interface_en.pdf) is property of someone else, most likely the GOIP manufacturer.

System requirements

A GOIP SMS Gateway
Server with PHP > 5.4 working
CLI access for the keepalive.php (not mandatory)

Installation

Copy the project to a server that has IP access to the GOIP
Adjust GOIP's SMS settings (see screenshot in /doc)
Run keepalive.php to catch the port number (see screenshot in /doc)
Rename settings_dist.php as settings.php
Fill the blanks in settings.php
Start sending SMS messages through the line command

Usage

Sending messages

To send an SMS message, call the script like example below:

 $ php send.php 0121212123 "Hello World!"

Answers

If everything OK, the script will return "1". Example:

 $ php send.php 0121212123 "Hello World!"
 1
 $

But, if something wrong happend (like incorrect phone number), the GOIP will return the error and the script will pass the error to tty. The error message print the step with problem. Example with a incorrect number:

 $ php send.php 0123 "Hello World!"
 Error in SubmitNumberStatus: ERROR 8622 1 errorstatus:38
 $

When the script submitted the number, the GOIP returned "ERROR 8622 1 errorstatus:38". The message "Error in SubmitNumberStatus" was inserted at the moment correct: when the script push the number and the GOIP return with an error.

GOIP keep alive

keepalive.php listens to GOIP messages in a specific address and port (set in GOIP management) and responds to keepalive messages. This functionality is NOT required for sending SMS messages.

Usage: php keepalive.php SERVERIPADDRESS PORT

The IP address is the server's address that runs the keepalive.php as it binds to a specific address. Adjust the IP address and port accordingly with the GOIP management. See screenshots from the doc directory.

Use GNU Screen or similar to keep the script running on your server. On Windows just leave the terminal window open.

lastwhitebird / goip-php

Maintainers

Details