Updated Readme For Release:

- Added inbound message example.
- Added message search example.
- Added all verify examples.

Author: tjlytle

README.md

@@ -3,7 +3,7 @@ Nexmo Client Library for PHP
 [![Build Status](https://api.travis-ci.org/Nexmo/nexmo-php.svg?branch=master)](https://travis-ci.org/Nexmo/nexmo-php)
 
 This is the PHP client library for use Nexmo's API. To use this, you'll need a Nexmo account. Sign up [for free at 
-nexmo.com][signup].
+nexmo.com][signup]. This is currently a beta release, see [contributing](#contributing) for more information.
 
  * [Installation](#installation)
  * [Usage](#usage)
@@ -55,7 +55,7 @@ The API response data can be accessed as array properties of the message.
 
     echo "Sent message to " . $message['to'] . ". Balance is now " . $message['remaining-balance'] . PHP_EOL;
 
-The message objects is a more expressive way to create and send messages. Each message type can be constructed with the 
+**A message object** is a more expressive way to create and send messages. Each message type can be constructed with the 
 required parameters, and a fluent interface provides access to optional parameters.
 
     $text = new \Nexmo\Message\Text(NEXMO_TO, NEXMO_FROM, 'Test message using PHP client library');
@@ -85,6 +85,97 @@ specific message data can be accessed using array notation, passing an index to
 
 The [send example][send_example] also has full working examples.
 
+### Receiving A Message
+
+Inbound messages are [sent to your application as a webhook][doc_inbound], and the client library provides a way to 
+create an inbound message object from a webhook:
+
+    $inbound = \Nexmo\Message\InboundMessage::createFromGlobals();
+    if($inbound->isValid()){
+        error_log($inbound->getBody());
+    } else {
+        error_log('invalid message');
+    }
+    
+You can also access the webhook data as an arry:
+
+    $inbound = \Nexmo\Message\InboundMessage::createFromGlobals();
+    error_log($inbound['to']);
+
+### Fetching A Message
+
+You can retrieve a message log from the API using the ID of the message:
+
+    $message = $client->message()->search('02000000DA7C52E7');
+    echo "The body of the message was: " . $message->getBody();
+
+If the message was sent to a Nexmo virtual number, the object will be an instance of `Nexmo\Message\InboundMessage`, if 
+the message was sent from your account, it will be an instance of `Nexmo\Message\Message`. You can also pass a message 
+object to the client:
+
+    $message = new \Nexmo\Message\InboundMessage('02000000DA7C52E7');
+    $client->message()->search($message);
+    echo "The body of the message was: " . $message->getBody();
+
+### Starting a Verification
+
+Nexmo's [Verify API][doc_verify] makes it easy to prove that a user has provided their own phone number during signup, 
+or implement second factor authentication during signin.
+
+You can start a verification process using a simple array:
+
+    $verification = $client->verify()->start([
+        'number' => '14845551212',
+        'brand'  => 'My App'
+    ]);
+    echo "Started verification with an id of: " . $verification->getRequestId();
+
+Or you can pass the client a verification object:
+
+    $verification = new \Nexmo\Verify\Verification('14845551212', 'My App');
+    $client->verify()->start($verification);
+    echo "Started verification with an id of: " . $verification->getRequestId();
+    
+### Controlling a Verification
+    
+To cancel an in-progress verification, or to trigger the next attempt to send the confirmation code, you can pass 
+either an exsisting verification object to the client library, or simply use a request ID:
+
+    $client->verify()->trigger('00e6c3377e5348cdaf567e1417c707a5');
+    
+    $verification = new \Nexmo\Verify\Verification('00e6c3377e5348cdaf567e1417c707a5');
+    $client->verify()->cancel($verification);
+
+### Checking A Verification
+
+In the same way, checking a verification requires the code the user provided, and an exiting verification object:
+
+    $verification = new \Nexmo\Verify\Verification('00e6c3377e5348cdaf567e1417c707a5');
+    $client->verify()->check($verification, '1234');
+ 
+Or a request ID:
+
+    $client->verify()->check('00e6c3377e5348cdaf567e1417c707a5', '1234');
+
+### Searching For A Verification
+
+You can check the status of a verification, or access the results of past verifications using either an exsisting 
+verification object, or a request ID. The verification object will then provide a rich interface:
+
+    $verification = new \Nexmo\Verify\Verification('00e6c3377e5348cdaf567e1417c707a5');
+    $client->verify()->search($verification);
+    
+    echo "Codes checked for verification: " . $verification->getRequestId() . PHP_EOL;
+    foreach($verification->getChecks() as $check){
+        echo $check->getDate()->format('d-m-y') . ' ' . $check->getStatus() . PHP_EOL;
+    }
+
+You can also access the raw API response here using array access:
+
+    $verification = new \Nexmo\Verify\Verification('00e6c3377e5348cdaf567e1417c707a5');
+    $client->verify()->search($verification);
+    echo "Verification cost was: " . $verification['price'] . PHP_EOL;
+    
 API Coverage
 ------------
 
@@ -111,9 +202,9 @@ API Coverage
 * Messaging 
     * [X] Send
     * [ ] Delivery Receipt
-    * [ ] Inbound Messages
-    * [ ] Search
-        * [ ] Message
+    * [X] Inbound Messages
+    * [X] Search
+        * [X] Message
         * [ ] Messages
         * [ ] Rejections
     * US Short Codes
@@ -145,6 +236,8 @@ This library is released under the [MIT License][license]
 
 [signup]: https://dashboard.nexmo.com/sign-up?utm_source=DEV_REL&utm_medium=github&utm_campaign=[LANGUAGE]-client-library
 [doc_sms]: https://docs.nexmo.com/api-ref/sms-api?utm_source=DEV_REL&utm_medium=github&utm_campaign=[LANGUAGE]-client-library
+[doc_inbound]: https://docs.nexmo.com/messaging/sms-api/api-reference#inbound?utm_source=DEV_REL&utm_medium=github&utm_campaign=[LANGUAGE]-client-library
+[doc_verify]: https://docs.nexmo.com/verify/api-reference?utm_source=DEV_REL&utm_medium=github&utm_campaign=[LANGUAGE]-client-library
 [license]: LICENSE.txt
 [send_example]: examples/send.php
 [spec]: https://github.com/Nexmo/client-library-specification