2024-08-09 23:07:12 +08:00
|
|
|
|
# test-php-rest-api-user
|
|
|
|
|
|
2024-08-10 01:51:29 +08:00
|
|
|
|
**Тестовое задание REST API на PHP**
|
|
|
|
|
|
2024-08-10 14:08:56 +08:00
|
|
|
|
## Установка / Запуск
|
|
|
|
|
|
|
|
|
|
### Первый способ (простой)
|
|
|
|
|
1. Открыть корневую директорию сайта (в которой файл `installed`)
|
|
|
|
|
2. Открыть консоль в данной директории
|
|
|
|
|
3. Выполнить комманду `php -S 0.0.0.0:8888`
|
|
|
|
|
4. Теперь сайт доступен по адресу [http://localhost:8888](http://localhost:8888)
|
|
|
|
|
|
|
|
|
|
### Второй способ (сложнее)
|
|
|
|
|
1. Установить `nginx` и `php-fpm`
|
|
|
|
|
2. Поместить содержимое сайта в нужную директорию
|
|
|
|
|
3. Настроить **nginx** так, как этот делается для **Wordpress**
|
|
|
|
|
4. Теперь сайт доступен по адресу который указан в nginx (обычно это [http://localhost:80](http://localhost:80))
|
|
|
|
|
|
|
|
|
|
|
2024-08-10 14:14:39 +08:00
|
|
|
|
## Конфигурация
|
|
|
|
|
Все необходимое для настройки и конфигурации сайта находится в директории `config`
|
|
|
|
|
|
|
|
|
|
### `0000.root.php`
|
|
|
|
|
Содержит базовую информацию о сайте (не важную для API)
|
|
|
|
|
|
|
|
|
|
### `0001.db.php`
|
|
|
|
|
Содержит настройки подключения к Базе Данных
|
|
|
|
|
|
|
|
|
|
### `0005.user.php`
|
|
|
|
|
Содержит конфигурацию для работы с пользователями
|
|
|
|
|
|
|
|
|
|
|
2024-08-10 01:51:29 +08:00
|
|
|
|
## Документация API
|
|
|
|
|
|
2024-08-10 14:15:20 +08:00
|
|
|
|
### [Postman](https://www.postman.com/material-observer-62618807/workspace/public-data/collection/37579698-ff75f993-cc82-4704-aea4-612718b8a06b?action=share&creator=37579698)
|
|
|
|
|
|
2024-08-10 01:51:29 +08:00
|
|
|
|
### POST `/api/v1/createUser`
|
2024-08-10 01:54:28 +08:00
|
|
|
|
Создание пользователя
|
|
|
|
|
|
2024-08-10 01:51:29 +08:00
|
|
|
|
Параметр | Описание
|
|
|
|
|
--- | ---
|
|
|
|
|
login | Обязательное поле (1-32 символа)
|
|
|
|
|
password | Обязательное поле (от 8 символов)
|
|
|
|
|
|
2024-08-10 01:54:28 +08:00
|
|
|
|
|
2024-08-10 01:51:29 +08:00
|
|
|
|
### POST `/api/v1/authUser`
|
2024-08-10 01:54:28 +08:00
|
|
|
|
Авторизация и получение токена
|
|
|
|
|
|
2024-08-10 01:51:29 +08:00
|
|
|
|
Параметр | Описание
|
|
|
|
|
--- | ---
|
|
|
|
|
login | Обязательное поле (1-32 символа)
|
|
|
|
|
password | Обязательное поле (от 8 символов)
|
|
|
|
|
|
2024-08-10 01:54:28 +08:00
|
|
|
|
|
2024-08-10 01:51:29 +08:00
|
|
|
|
### GET `/api/v1/getUser`
|
2024-08-10 01:54:28 +08:00
|
|
|
|
Получение информации о пользователе
|
|
|
|
|
|
2024-08-10 01:51:29 +08:00
|
|
|
|
Параметр | Описание
|
|
|
|
|
--- | ---
|
|
|
|
|
login | Обязательное поле (1-32 символа)
|
|
|
|
|
|
2024-08-10 01:54:28 +08:00
|
|
|
|
|
2024-08-10 01:51:29 +08:00
|
|
|
|
### PATCH `/api/v1/updateUserInfo`
|
2024-08-10 01:54:28 +08:00
|
|
|
|
Обновление поля info у пользователя
|
|
|
|
|
|
2024-08-10 01:51:29 +08:00
|
|
|
|
Параметр | Описание
|
|
|
|
|
--- | ---
|
|
|
|
|
token | Обязательное поле (токен, который выдали при авторизации)
|
|
|
|
|
newInfo | Обязательное поле (без ограничений)
|
|
|
|
|
|
2024-08-10 01:54:28 +08:00
|
|
|
|
|
2024-08-10 01:51:29 +08:00
|
|
|
|
### DELETE `/api/v1/deleteUser`
|
2024-08-10 01:54:28 +08:00
|
|
|
|
Удаление пользователя
|
|
|
|
|
|
2024-08-10 01:51:29 +08:00
|
|
|
|
Параметр | Описание
|
|
|
|
|
--- | ---
|
|
|
|
|
token | Обязательное поле (токен, который выдали при авторизации)
|