Book Image

RESTful PHP Web Services

By : Samisa Abeysinghe
Book Image

RESTful PHP Web Services

By: Samisa Abeysinghe

Overview of this book

<p>Representational State Transfer (REST) is a form of software architecture; systems that follow it are often called RESTful. It is the architectural style that drives the World Wide Web (the motivation for REST was to capture elements that made the Web successful), and RESTful web services use simple protocols already familiar to web developers. RESTful web services are found in lots of places with big name Web APIs such as Flickr, and Yahoo search following a REST-based approach.<br /><br />With any architectural style or approach, struggling with its basic concepts is just one problem – implementation in your favorite language is another, and that's where this book comes in. If you're a PHP developer, this book will show you how to create and consume RESTful web services in PHP, and make your services work well in the context of the Web.<br /><br />You will learn about the basic concepts of REST, and then look at PHP tools, libraries and techniques for working with RESTful web services. You will see how to use other RESTful services from your PHP applications, and also how to engineer your PHP applications to make them RESTful.<br /><br />This book is about implementing RESTful web services in PHP, and so the book is packed with example code and careful explanations.</p>
Table of Contents (15 chapters)
RESTful PHP Web Services
Credits
About the Author
About the Reviewers
Preface
Index

post Method


The post method takes three parameters, the service URL, data to be posted and an optional third parameter that specifies the content type.

public function post($url, $data, $content_type = "application/x-www-form-urlencoded") {

If CURL is available, the given data would be posted to the given service URL.

if ($this->with_curl) {
            $curl = curl_init();
            curl_setopt($curl, CURLOPT_HTTPHEADER, Array (
                "Content-Type: " . $content_type
            ));
            curl_setopt($curl, CURLOPT_URL, $url);
            curl_setopt($curl, CURLOPT_POST, TRUE);
            curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
            curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
            curl_setopt($curl, CURLOPT_USERAGENT, RESTClient :: USER_AGENT);
            $result = curl_exec($curl);
            curl_close($curl);
        } 

We set the content type as an HTTP header. So if the user of the class provided a custom content type that would be reflected in the request sent to the service. Again, the CURL POST syntax used in this method was discussed in Chapter 2 in detail.

If CURL is not available, as in the case of get method, we use fopen to get the job done.

} else {
$opts = array (
'http' => array (
'method' => "POST",
'header' => "User-Agent: " . RESTClient :: USER_AGENT . "\r\n" .
                    "Content-Type: " . $content_type . "\r\n" .
                    "Content-length: " . strlen($data
                ) . "\r\n",
                'content' => $data
            ));

            $context = stream_context_create($opts);

            $fp = fopen($url, 'r', false, $context);
            $result = fpassthru($fp);
            fclose($fp); 

        }