Added PHP/curl sample.

Author: Vladislav Gubarev

README.md

@@ -49,9 +49,6 @@ This project run to help API users with ready-to-use examples in a set of the mo
   * [fetch](./js/fetch)
   * [Axios](./js/axios)
   * [jQuery](./js/jquery)
-
-Coming soon:
-
 * `PHP`:
   * [cURL](./php/curl)
 

php/curl/README.md

@@ -0,0 +1,46 @@
+# API4AI OCR text recognition sample
+
+This directory contains a minimalistic sample that sends requests to the API4AI Text Recognition API.
+The sample is implemented in `PHP` using [cURL](https://www.php.net/manual/ru/book.curl.php) extension.
+
+
+## Overview
+
+This API processes images and performs Optical Character Recognition.
+
+
+## Getting started
+
+*PHP version `7.x` or greater and `php-curl` extension is required to run this script.*
+
+Try sample with default args:
+
+```bash
+php index.php
+```
+
+Try sample with your local image:
+
+```bash
+php index.php image.jpg
+```
+
+
+## About API keys
+
+This demo by default sends requests to free endpoint at `demo.api4ai.cloud`.
+Demo endpoint is rate limited and should not be used in real projects.
+
+Use [RapidAPI marketplace](https://rapidapi.com/api4ai-api4ai-default/api/ocr43/details) to get the API key. The marketplace offers both
+free and paid subscriptions.
+
+[Contact us](https://api4.ai/contacts?utm_source=ocr_example_repo&utm_medium=readme&utm_campaign=examples) in case of any questions or to request a custom pricing plan
+that better meets your business requirements.
+
+
+## Links
+
+* 📩 Email: hello@api4.ai
+* 🔗 Website: [http://api4.ai](https://api4.ai?utm_source=ocr_example_repo&utm_medium=readme&utm_campaign=examples)
+* 🤖 Telegram demo bot: https://t.me/a4a_ocr_bot
+* 🔵 Our API at RapidAPI marketplace: https://rapidapi.com/api4ai-api4ai-default/api/ocr43/details

php/curl/image.jpg

@@ -0,0 +1,74 @@
+#!/usr/bin/env php
+
+<?php
+// Example of using API4AI OCR text recognition.
+
+// Use 'demo' mode just to try api4ai for free. Free demo is rate limited.
+// For more details visit:
+//   https://api4.ai
+
+// Use 'rapidapi' if you want to try api4ai via RapidAPI marketplace.
+// For more details visit:
+//   https://rapidapi.com/api4ai-api4ai-default/api/ocr43/details
+$MODE = 'demo';
+
+// Your RapidAPI key. Fill this variable with the proper value if you want
+// to try api4ai via RapidAPI marketplace.
+$RAPIDAPI_KEY = null;
+
+$OPTIONS = [
+    'demo' => [
+        'url' => 'https://demo.api4ai.cloud/ocr/v1/results',
+        'headers' => ['A4A-CLIENT-APP-ID: sample']
+    ],
+    'rapidapi' => [
+        'url' => 'https://ocr43.p.rapidapi.com/v1/results',
+        'headers' => ["X-RapidAPI-Key: {$RAPIDAPI_KEY}"]
+    ]
+];
+
+// Initialize request session.
+$request = curl_init();
+
+// Check if path to local image provided.
+$data = ['url' => 'https://storage.googleapis.com/api4ai-static/samples/ocr-1.png'];
+if (array_key_exists(1, $argv)) {
+    if (strpos($argv[1], '://')) {
+        $data = ['url' => $argv[1]];
+    } else {
+        $filename = pathinfo($argv[1])['filename'];
+        $data = ['image' => new CURLFile($argv[1], null, $filename)];
+    }
+}
+
+// Set request options.
+curl_setopt($request, CURLOPT_URL, $OPTIONS[$MODE]['url']);
+curl_setopt($request, CURLOPT_HTTPHEADER, $OPTIONS[$MODE]['headers']);
+curl_setopt($request, CURLOPT_POST, true);
+curl_setopt($request, CURLOPT_POSTFIELDS, $data);
+curl_setopt($request, CURLOPT_RETURNTRANSFER, true);
+
+// Execute request.
+$result = curl_exec($request);
+
+// Decode response.
+$raw_response = json_decode($result, true);
+
+// Print raw response.
+echo join('',
+          ["💬 Raw response:\n",
+           json_encode($raw_response),
+           "\n"]);
+
+// Parse response and get recognized text.
+$text = $raw_response['results'][0]['entities'][0]['objects'][0]['entities'][0]['text'];
+
+// Close request session.
+curl_close($request);
+
+// Print recognized text.
+echo join('',
+          ["\n💬 Recognized text: \n",
+           $text,
+           "\n"]);
+?>