From 1fd653d1382686008bea144f16213d53c7e5e029 Mon Sep 17 00:00:00 2001
From: Iana Soloduha <yana.s@ticketscloud.com>
Date: Mon, 28 Jul 2025 22:38:48 +0300
Subject: [PATCH] [8699y3tet] Tested and added PHP example.

---
 README.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 48 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index ab59653..66c5bee 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,52 @@ NB:
 - Стейдж (тестовая): `simple.stage.freetc.net:443`
 - Продакшен: `simple.ticketscloud.com:443`
 
+## Пример клиента на PHP (спасибо https://github.com/feldwebel)
+
+Должно быть установлено расширение grpc, компилятор protobuf и собран grpc_php_plugin.
+
+Компилируем .proto файлы:
+```
+protoc --proto_path=proto --php_out=generated --grpc_out=generated --plugin=protoc-gen-grpc=<путь к grpc_php_plugin> proto/*.proto
+```
+
+client.php:
+```
+#!/usr/bin/env php
+<?php
+require "vendor/autoload.php";
+// Если используем composer, можно добавить в composer.json
+// "autoload": {
+//   "psr-4": {
+//     "V2\\": "php_generated/V2/",
+//     "GPBMetadata\\": "php_generated/GPBMetadata/"
+//   }
+// }
+
+use Grpc\ChannelCredentials;
+use V2\SimpleClient;
+use V2\CountriesRequest;
+
+$host = "simple.stage.freetc.net:443";
+$key = "<key>";  // Вписать API ключ
+$cred = [
+    "credentials" => ChannelCredentials::createSsl(), // защищённое соединение
+];
+$opt = [
+    "authorization" => [$key], // ключ упакован в массив
+];
+
+$client = new SimpleClient($host, $cred);
+
+$countriesRequest = new CountriesRequest()->setIds(["ZM"]);
+
+$countries = $client->Countries($countriesRequest, $opt)->responses();
+
+foreach ($countries as $country) {
+    var_dump($country->getName());
+}
+```
+
 ## Пример клиента на Python:
 
 1. Получаем в ЛК или у менеджеров Ticketscloud ключ доступа (API key).
@@ -33,7 +79,7 @@ NB:
     ```pip install grpcio-tools```
 
 3. Компилируем .proto-файлы в обёртки на Python:
-    
+
     ```mkdir proto/build && python -m grpc_tools.protoc -Iproto --python_out=proto --grpc_python_out=proto ./proto/*.proto```
 
     В каталоге proto/build появятся *.py-файлы.
@@ -42,7 +88,7 @@ NB:
 
     ```python
     import grpc
-    
+
     import service_pb2_grpc
     import events_pb2