forecho / yii2-rest-api
Yii 2 REST API Project Template
Fund package maintenance!
Open Collective
blog-1251237404.cos.ap-guangzhou.myqcloud.com/20190424153510.png
blog-1251237404.cos.ap-guangzhou.myqcloud.com/20190424153431.png
Installs: 341
Dependents: 0
Suggesters: 0
Security: 0
Stars: 40
Watchers: 4
Forks: 14
Open Issues: 3
Type:project
Requires
- php: >=7.2
- sizeg/yii2-jwt: ^2.0
- yiier/yii2-helpers: ^2.0
- yiisoft/yii2: ~2.0.14
- yiisoft/yii2-swiftmailer: ~2.0.0 || ~2.1.0
- yiithings/yii2-dotenv: ^1.0
Requires (Dev)
- codeception/codeception: ^4.0
- codeception/module-asserts: ^1.0.0
- codeception/module-filesystem: ^1.0.0
- codeception/module-phpbrowser: ^1.0.0
- codeception/module-rest: ^1.0.0
- codeception/module-yii2: ^1.0.0
- codeception/specify: ~0.4.6
- codeception/verify: ~0.5.0 || ~1.1.0
- mis/yii2-ide-helper: ^1.0
- phpro/grumphp: ^0.19.1
- squizlabs/php_codesniffer: ^3.5.5
- symfony/browser-kit: >=2.7 <=4.2.4
- yiisoft/yii2-debug: ~2.1.0
- yiisoft/yii2-faker: ~2.0.0
- yiisoft/yii2-gii: ~2.1.0
This package is auto-updated.
Last update: 2024-11-20 00:20:16 UTC
README
Yii 2 REST API Project Template
Yii 2 REST API Project Template is a skeleton Yii 2 application best for rapidly creating small rest api projects.
The template contains the basic features including user join/login api. It includes all commonly used configurations that would allow you to focus on adding new features to your application.
REQUIREMENTS
The minimum requirement by this project template that your Web server supports PHP 7.2.0.
INSTALLATION
Install via Composer
If you do not have Composer, you may install it by following the instructions at getcomposer.org.
You can then install this project template using the following command:
composer create-project --prefer-dist forecho/yii2-rest-api <rest-api>
cd <rest-api>
cp .env.example .env
php yii generate/key # optional
chmod 777 -R runtime/
Now you should be able to access the application through the following URL, assuming rest-api
is the directory
directly under the Web root.
http://localhost/<rest-api>/web/
Install from GitHub
Accessing Use this template Create a new repository from yii2-rest-api
git clone xxxx cd <rest-api> cp .env.example .env chmod 777 -R runtime/
You can then access the application through the following URL:
http://localhost/<rest-api>/web/
Install with Docker
Update your vendor packages
docker-compose run --rm php composer update --prefer-dist
Run the installation triggers (creating cookie validation code)
docker-compose run --rm php composer install
Start the container
docker-compose up -d
You can then access the application through the following URL:
http://127.0.0.1:8000
NOTES:
- Minimum required Docker engine version
17.04
for development (see Performance tuning for volume mounts) - The default configuration uses a host-volume in your home directory
.docker-composer
for composer caches
Check out the packages
Use
At this time, you have a RESTful API server running at http://127.0.0.1:8000
. It provides the following endpoints:
GET /health-check
: a health check service provided for health checking purpose (needed when implementing a server cluster)POST /v1/join
: create a userPOST /v1/login
: authenticates a user and generates a JWTPOST /v1/refresh-token
: refresh a JWT
Try the URL http://localhost:8000/health-check
in a browser, and you should see something like {"code":0,"data":"OK","message":"成功"}
displayed.
If you have cURL
or some API client tools (e.g. Postman), you may try the following
more complex scenarios:
# create a user via: POST /v1/join curl -X POST -H "Content-Type: application/json" -d '{"username":"demo","email":"demo@email.com","password":"pass123"}' http://localhost:8000/v1/join # should return like: {"code":0,"data":{"username":"demo","email":"demo@email.com","status":1,"created_at":"2020-07-18T16:38:11+08:00","updated_at":"2020-07-18T16:38:11+08:00","id":17},"message":"成功"} # authenticate the user via: POST /v1/login curl -X POST -H "Content-Type: application/json" -d '{"username": "demo", "password": "pass123"}' http://localhost:8000/v1/login # should return like: {"code":0,"data":{"user":{"id":4,"username":"dem211o1","avatar":"","email":"de21mo1@mail.com","status":1,"created_at":"2020-07-17T23:49:39+08:00","updated_at":"2020-07-17T23:49:39+08:00"},"token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiIsImp0aSI6IllpaS1SRVNULUFQSSJ9.eyJpc3MiOiJodHRwOlwvXC9sb2NhbGhvc3QiLCJqdGkiOiJZaWktUkVTVC1BUEkiLCJpYXQiOjE1OTUwNjQ5NzIsImV4cCI6MTU5NTMyNDE3MiwidXNlcm5hbWUiOiJkZW0yMTFvMSIsImlkIjo0fQ.y2NSVQe-TQ08RnXnF-o55h905G9WHo6GYHNaUWlKjDE"},"message":"成功"} # refresh a JWT curl -X POST -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiIsImp0aSI6IllpaS1SRVNULUFQSSJ9.eyJpc3MiOiJodHRwOlwvXC9sb2NhbGhvc3QiLCJqdGkiOiJZaWktUkVTVC1BUEkiLCJpYXQiOjE1OTUwNjQ5NzIsImV4cCI6MTU5NTMyNDE3MiwidXNlcm5hbWUiOiJkZW0yMTFvMSIsImlkIjo0fQ.y2NSVQe-TQ08RnXnF-o55h905G9WHo6GYHNaUWlKjDE' http://localhost:8000/v1/refresh-token # should return like: {"code":0,"data":{"user":{"id":4,"username":"dem211o1","avatar":"","email":"de21mo1@mail.com","status":1,"created_at":"2020-07-17T23:49:39+08:00","updated_at":"2020-07-17T23:49:39+08:00"},"token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiIsImp0aSI6IllpaS1SRVNULUFQSSJ9.eyJpc3MiOiJodHRwOlwvXC9sb2NhbGhvc3QiLCJqdGkiOiJZaWktUkVTVC1BUEkiLCJpYXQiOjE1OTUwNjQ5NzIsImV4cCI6MTU5NTMyNDE3MiwidXNlcm5hbWUiOiJkZW0yMTFvMSIsImlkIjo0fQ.y2NSVQe-TQ08RnXnF-o55h905G9WHo6GYHNaUWlKjDE"},"message":"成功"}