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

Версія 18.1 додана 2024/05/08 21:00 автором Ashterix
Сховати останніх авторів
Ashterix 7.2 1 {{box cssClass="floatinginfobox" width="400px" 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
9 {{code language="json"}}
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
45 {{code language="php"}}
Ashterix 12.1 46 <?php
47 // config/bundles.php
48
49 return [
Ashterix 7.2 50 // ...
Ashterix 12.1 51 Ufo\JsonRpcBundle\UfoJsonRpcBundle::class => ['all' => true],
52 // ...
Ashterix 7.2 53 ];
54 {{/code}}
55
56
57
58 = Крок 3: Додавання параметрів =
59
60 {{warning}}
61 **Якщо ви виконали «Крок 0», це налаштовано автоматично і ви можете пропустити цей крок.**
62 {{/warning}}
63
Ashterix 7.3 64 В разі ручного налаштування бандлу, додайте (% id="cke_bm_4952S" style="display:none" %) (%%)до папки {{code language="none"}}config/packages{{/code}} файл {{code language="none"}}ufo_json_rpc.yaml{{/code}} із таким вмістом:
Ashterix 7.2 65
Ashterix 7.3 66 {{code language="yaml"}}
67 # config/packages/ufo_json_rpc.yaml
68 ufo_json_rpc:
69 security:
Ashterix 10.3 70 protected_methods: ['POST'] # Protection of GET and POST requests
Ashterix 7.3 71 token_key_in_header: 'Ufo-RPC-Token' # Name of the key in the header
72 clients_tokens:
Ashterix 10.3 73 - 'ClientTokenExample' # Hardcoded token example. Importantly!!! Replace or delete it!
74 - '%env(resolve:UFO_API_TOKEN)%' # Token example from .env.local
Ashterix 7.3 75
76 # Configuration for API documentation
77 docs:
78 # Optional response details
79 response:
80 key_for_methods: services # Key used to map services for API methods
81 # Information about validations
82 validations:
83 json_schema: false # Indicates if JSON-schema is used for method validation
84 symfony_asserts: false # Indicates if an array of Symfony validation constraints is used
Ashterix 7.2 85
Ashterix 7.3 86 {{/code}}
Ashterix 7.2 87
Ashterix 7.3 88 (% class="wikigeneratedid" %)
Ashterix 7.4 89 Детальний огляд параметрів налаштування доступний в розділі [[Налаштування бандлу>>doc:docs.JsonRpcBundle.config]]
Ashterix 7.2 90
Ashterix 8.3 91
92
Ashterix 7.3 93 = Крок 4: Реєстрація маршрутів =
Ashterix 7.2 94
Ashterix 7.3 95 {{warning}}
96 **Якщо ви виконали «Крок 0», це налаштовано автоматично і ви можете пропустити цей крок.**
97 {{/warning}}
Ashterix 7.2 98
Ashterix 7.3 99 (% 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 100
Ashterix 7.3 101 {{code language="yaml"}}
102 # config/routes/ufo_json_rpc.yaml
103 ufo_json_rpc:
104 resource: ../../vendor/ufo-tech/json-rpc-bundle/config/router.yaml
105 prefix: /api
106 trailing_slash_on_root: false
107 {{/code}}
108
Ashterix 10.2 109 Якщо лишити налаштування як є, то RPC API буде доступне по шляху {{code language="none"}}/api{{/code}} наприклад {{code language="none"}}https://example.com/api{{/code}}
110 Якщо вам потрібно змінити шлях, змініть налаштування маршруту таким чином:
Ashterix 7.3 111
Ashterix 10.2 112 {{code language="yaml"}}
113 # config/routes/ufo_json_rpc.yaml
114 ufo_json_rpc_bundle:
115 resource: ../../vendor/ufo-tech/json-rpc-bundle/config/router.yaml
116 prefix: /my_custom_api_route #вкажіть тут альтернативний шлях
117 trailing_slash_on_root: false
118 {{/code}}
Ashterix 7.3 119
Ashterix 10.2 120 Тепер API буде доступне по шляху {{code language="none"}}https://example.com/my_custom_api_route{{/code}}
Ashterix 7.3 121
Ashterix 10.3 122
Ashterix 12.1 123
Ashterix 10.3 124 = Крок 5: Profit =
125
Ashterix 10.2 126 {{success}}
127 **Вітаю!!!** Ваш RPC сервер готовий до роботи!!!
128 {{/success}}
Ashterix 1.1 129
Ashterix 12.1 130 = Що далі? =
Ashterix 10.3 131
Ashterix 13.1 132 == А воно точно працює? (с) ==
Ashterix 10.3 133
134 GET запит на точку входу поверне документацію по наявним методам і параметрам, які вони приймають.
135
Ashterix 14.1 136 {{warning}}
137 Формат документації може змінюватися в залежності від ваших налаштувань. Див. [[Налаштування бандлу>>doc:docs.JsonRpcBundle.config]]
138 {{/warning}}
139
Ashterix 10.3 140 **{{code language="none"}}GET: /api{{/code}}**
141
142 {{code language="json"}}
143 {
144 "transport": "POST",
145 "envelope": "JSON-RPC-2.0/UFO-RPC-6",
146 "contentType": "application/json",
147 "description": "",
148 "target": "/api",
149 "methods": {
150 "ping": {
151 "name": "ping",
152 "description": "",
153 "parameters": [],
154 "returns": "string",
155 "responseFormat": "string"
156 }
157 }
158 }
159 {{/code}}
160
161 Метод {{code language="none"}}ping{{/code}} встановлений одразу, ви можете одразу виконати POST запит, щоб переконатися, що сервер працює.
162
163 (% id="cke_bm_115746S" style="display:none" %)** **(%%)**{{code language="none"}}POST: /api{{/code}}**
164
165 **Request**:
166
167 {{code language="json"}}
168 {
169 "id": "some_request_id",
170 "method": "ping"
171 }
172 {{/code}}
173
174 **Response**:
175
176 {{code language="json"}}
177 {
178 "id": "some_request_id",
179 "result": "PONG"
180 }
181 {{/code}}
Ashterix 12.1 182
Ashterix 15.1 183 == Змініть [[налаштування>>doc:docs.JsonRpcBundle.config]] під власні потреби ==
Ashterix 12.1 184
185
Ashterix 18.1 186 == Додайте [[власні процедури>>doc:docs.JsonRpcBundle.add_rpc_service.WebHome]] ==