Вікі-код для 1. Встановлення

Остання зміна 2024/07/11 09:57 автором Ashterix
Сховати останніх авторів
Ashterix 20.1 1 {{box cssClass="floatinginfobox" title="**Зміст**"}}
Ashterix 1.1 2 {{toc/}}
3 {{/box}}
4
Ashterix 7.2 5 = Крок 0: Налаштування composer.json =
Ashterix 1.1 6
7 Для того, щоб при додаванні пакету, ваш Symfony Flex автоматично зробив всі необхідні налаштування, потрібно внести наступні зміни в ваш {{code language="none"}}composer.json{{/code}}
8
Ashterix 19.1 9 {{code language="json" layout="LINENUMBERS" title="composer.json"}}
Ashterix 1.1 10 {
11 "extra" : {
12 "symfony": {
13 "endpoint": [
14 "https://api.github.com/repos/ufo-tech/recipes/contents/index.json?ref=main",
15 "flex://defaults"
16 ]
17 }
18 },
19 }
20 {{/code}}
21
Ashterix 6.2 22 {{info}}
Ashterix 8.1 23 Детально про Symfony Flex в [[документації Symfony>>url:https://symfony.com/doc/current/setup/flex_private_recipes.html]]
Ashterix 6.2 24 {{/info}}
Ashterix 1.1 25
Ashterix 7.2 26
Ashterix 7.1 27 = Крок 1: Встановлення =
Ashterix 1.1 28
29 В консолі в теці проєкту виконайте цю команду, щоб завантажити останню версію цього пакету:
30
31 {{code language="bash"}}
Ashterix 6.1 32 composer require ufo-tech/json-rpc-bundle
Ashterix 1.1 33 {{/code}}
34
Ashterix 6.2 35 {{info}}
36 Ця команда актуальна якщо ви встановили Composer глобально, як описано в [[документації>>https://getcomposer.org/doc/00-intro.md]] Composer.
37 {{/info}}
Ashterix 1.1 38
Ashterix 7.2 39
40
41 = Крок 2: Реєстрація пакету =
42
43 Переконайтесь, що пакет автоматично зареєструвався в файлі {{code language="none"}}config/bundles.php{{/code}} вашого проєкту:
44
Ashterix 19.1 45 {{code language="php" layout="LINENUMBERS" title="config/bundles.php"}}
Ashterix 12.1 46 <?php
47
48 return [
Ashterix 7.2 49 // ...
Ashterix 12.1 50 Ufo\JsonRpcBundle\UfoJsonRpcBundle::class => ['all' => true],
51 // ...
Ashterix 7.2 52 ];
53 {{/code}}
54
55
56
57 = Крок 3: Додавання параметрів =
58
59 {{warning}}
60 **Якщо ви виконали «Крок 0», це налаштовано автоматично і ви можете пропустити цей крок.**
61 {{/warning}}
62
Ashterix 7.3 63 В разі ручного налаштування бандлу, додайте (% id="cke_bm_4952S" style="display:none" %) (%%)до папки {{code language="none"}}config/packages{{/code}} файл {{code language="none"}}ufo_json_rpc.yaml{{/code}} із таким вмістом:
Ashterix 7.2 64
Ashterix 19.1 65 {{code language="yaml" layout="LINENUMBERS" title="config/packages/ufo_json_rpc.yaml"}}
Ashterix 7.3 66 ufo_json_rpc:
67 security:
Ashterix 10.3 68 protected_methods: ['POST'] # Protection of GET and POST requests
Ashterix 7.3 69 token_key_in_header: 'Ufo-RPC-Token' # Name of the key in the header
70 clients_tokens:
Ashterix 10.3 71 - 'ClientTokenExample' # Hardcoded token example. Importantly!!! Replace or delete it!
72 - '%env(resolve:UFO_API_TOKEN)%' # Token example from .env.local
Ashterix 7.3 73
74 # Configuration for API documentation
75 docs:
76 # Optional response details
77 response:
78 key_for_methods: services # Key used to map services for API methods
79 # Information about validations
80 validations:
81 json_schema: false # Indicates if JSON-schema is used for method validation
82 symfony_asserts: false # Indicates if an array of Symfony validation constraints is used
Ashterix 7.2 83
Ashterix 7.3 84 {{/code}}
Ashterix 7.2 85
Ashterix 7.3 86 (% class="wikigeneratedid" %)
Ashterix 21.1 87 Детальний огляд параметрів налаштування доступний в розділі [[Налаштування бандлу>>doc:docs.JsonRpcBundle.config_v7.config]]
Ashterix 7.2 88
Ashterix 8.3 89
90
Ashterix 7.3 91 = Крок 4: Реєстрація маршрутів =
Ashterix 7.2 92
Ashterix 7.3 93 {{warning}}
94 **Якщо ви виконали «Крок 0», це налаштовано автоматично і ви можете пропустити цей крок.**
95 {{/warning}}
Ashterix 7.2 96
Ashterix 7.3 97 (% id="cke_bm_19449S" style="display:none" %) (%%)В разі ручного налаштування бандлу, додайте (% id="cke_bm_4952S" style="display:none" %) (%%)до папки {{code language="none"}}config/routes{{/code}} файл {{code language="none"}}ufo_json_rpc.yaml{{/code}} із таким вмістом:
Ashterix 7.2 98
Ashterix 19.1 99 {{code language="yaml" layout="LINENUMBERS" title="config/routes/ufo_json_rpc.yaml"}}
Ashterix 7.3 100 ufo_json_rpc:
101 resource: ../../vendor/ufo-tech/json-rpc-bundle/config/router.yaml
102 prefix: /api
103 trailing_slash_on_root: false
104 {{/code}}
105
Ashterix 10.2 106 Якщо лишити налаштування як є, то RPC API буде доступне по шляху {{code language="none"}}/api{{/code}} наприклад {{code language="none"}}https://example.com/api{{/code}}
107 Якщо вам потрібно змінити шлях, змініть налаштування маршруту таким чином:
Ashterix 7.3 108
Ashterix 19.1 109 {{code language="yaml" layout="LINENUMBERS" title="config/routes/ufo_json_rpc.yaml"}}
Ashterix 10.2 110 ufo_json_rpc_bundle:
111 resource: ../../vendor/ufo-tech/json-rpc-bundle/config/router.yaml
112 prefix: /my_custom_api_route #вкажіть тут альтернативний шлях
113 trailing_slash_on_root: false
114 {{/code}}
Ashterix 7.3 115
Ashterix 10.2 116 Тепер API буде доступне по шляху {{code language="none"}}https://example.com/my_custom_api_route{{/code}}
Ashterix 7.3 117
Ashterix 10.3 118
Ashterix 12.1 119
Ashterix 10.3 120 = Крок 5: Profit =
121
Ashterix 10.2 122 {{success}}
123 **Вітаю!!!** Ваш RPC сервер готовий до роботи!!!
124 {{/success}}
Ashterix 1.1 125
Ashterix 12.1 126 = Що далі? =
Ashterix 10.3 127
Ashterix 13.1 128 == А воно точно працює? (с) ==
Ashterix 10.3 129
130 GET запит на точку входу поверне документацію по наявним методам і параметрам, які вони приймають.
131
Ashterix 14.1 132 {{warning}}
Ashterix 21.1 133 Формат документації може змінюватися в залежності від ваших налаштувань. Див. [[Налаштування бандлу>>doc:docs.JsonRpcBundle.config_v7.config]]
Ashterix 14.1 134 {{/warning}}
135
Ashterix 10.3 136 **{{code language="none"}}GET: /api{{/code}}**
137
138 {{code language="json"}}
139 {
140 "envelope": "JSON-RPC-2.0/UFO-RPC-6",
141 "contentType": "application/json",
142 "description": "",
Ashterix 20.2 143 "transport": {
144 "sync": {
145 "scheme": "https",
146 "host": "example.com",
147 "path": "/api",
148 "method": "POST"
149 }
150 },
Ashterix 10.3 151 "methods": {
Ashterix 20.2 152 "ping": {
153 "name": "ping",
Ashterix 10.3 154 "description": "",
155 "parameters": [],
156 "returns": "string",
157 "responseFormat": "string"
158 }
159 }
160 }
161 {{/code}}
162
163 Метод {{code language="none"}}ping{{/code}} встановлений одразу, ви можете одразу виконати POST запит, щоб переконатися, що сервер працює.
164
165 (% id="cke_bm_115746S" style="display:none" %)** **(%%)**{{code language="none"}}POST: /api{{/code}}**
166
167 **Request**:
168
169 {{code language="json"}}
170 {
171 "id": "some_request_id",
172 "method": "ping"
173 }
174 {{/code}}
175
176 **Response**:
177
178 {{code language="json"}}
179 {
180 "id": "some_request_id",
181 "result": "PONG"
182 }
183 {{/code}}
Ashterix 12.1 184
Ashterix 21.1 185 == Змініть [[налаштування>>doc:docs.JsonRpcBundle.config_v7.config]] під власні потреби ==
Ashterix 12.1 186
187
Ashterix 18.1 188 == Додайте [[власні процедури>>doc:docs.JsonRpcBundle.add_rpc_service.WebHome]] ==