|
1 | | - |
2 | 1 | <p align="center"> |
3 | | -<img style="text-aligh: center" src="https://15804523-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F77F3kdmGsRkZFelMUJq1%2Ficon%2FnsTZCyEjC1z8LJWkzLro%2F%D1%8B.svg?alt=media&token=ce321f03-8fdf-4c4d-aaef-888183f713f6" width="200" alt="Company logo"> |
| 2 | +<img style="text-align: center" src="https://15804523-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F77F3kdmGsRkZFelMUJq1%2Ficon%2FnsTZCyEjC1z8LJWkzLro%2F%D1%8B.svg?alt=media&token=ce321f03-8fdf-4c4d-aaef-888183f713f6" width="200" alt="Company logo"> |
4 | 3 | </p> |
5 | 4 |
|
6 | 5 | <p align="center"> |
7 | 6 | <b style="font-size: 2rem">PHP SDK for Nginx Unit</b> |
8 | 7 | </p> |
9 | 8 |
|
10 | 9 | <p align="center"> |
11 | | -<a href="https://packagist.org/packages/pavlusha311245/unit-php-sdk"><img src="https://img.shields.io/packagist/v/Pavlusha311245/unit-php-sdk?labelColor=%231e293b&color=%23702963&link=https%3A%2F%2Fpackagist.org%2Fpackages%2Fpavlusha311245%2Funit-php-sdk"></a> |
12 | | -<a href="https://unit-sdk.pavlusha.me/"><img src="https://img.shields.io/website?url=https%3A%2F%2Funit-sdk.pavlusha.me%2F&label=documentation&link=https%3A%2F%2Funit-sdk.pavlusha.me%2F"></a> |
| 10 | +<a href="https://packagist.org/packages/pavlusha311245/unit-php-sdk"><img src="https://img.shields.io/packagist/v/Pavlusha311245/unit-php-sdk?labelColor=%231e293b&color=%23702963&link=https%3A%2F%2Fpackagist.org%2Fpackages%2Fpavlusha311245%2Funit-php-sdk" alt="packagist link"></a> |
| 11 | +<a href="https://unit-sdk.pavlusha.me/"><img src="https://img.shields.io/website?url=https%3A%2F%2Funit-sdk.pavlusha.me%2F&label=documentation&link=https%3A%2F%2Funit-sdk.pavlusha.me%2F" alt="documentation link"></a> |
| 12 | +<img src="https://github.com/Pavlusha311245/nginx-unit-php-sdk/actions/workflows/deploy_codecov.yaml/badge.svg" alt="documentation link"> |
| 13 | +<a href="https://codecov.io/gh/Pavlusha311245/nginx-unit-php-sdk" > |
| 14 | + <img src="https://codecov.io/gh/Pavlusha311245/nginx-unit-php-sdk/graph/badge.svg?token=FGTTDSJ7BX" alt="Codecov dabge"/> |
| 15 | + </a> |
13 | 16 | </p> |
14 | 17 |
|
15 | | -## About |
16 | | - |
17 | | -SDK allows developers to interact with the Nginx Unit web server through php classes. This project will help embed web server management into your projects |
18 | | - |
19 | | -### Supported Versions |
20 | | - |
21 | | -| Version | Nginx Unit Capability | Supported | |
22 | | -|---------|:----------------------|--------------------| |
23 | | -| 0.6.x | 1.30.0 & 1.31.0 | :white_check_mark: | |
24 | | -| < 0.4.x | 1.30.0 | :x: | |
25 | | - |
26 | | -_THIS PROJECT IN DEVELOPMENT. DON'T USE IT IN PRODUCTION_ |
| 18 | +## About |
27 | 19 |
|
28 | | -## Quick start |
| 20 | +SDK allows developers to interact with the Nginx Unit web server through php classes. This project will help embed web |
| 21 | +server management into your projects |
| 22 | +> This project in development. Don't use it in production. Some features may not work correctly. Please report bugs and issues to the issue tracker. |
29 | 23 |
|
30 | | -### Pre-requirements |
| 24 | +### Requirements |
31 | 25 |
|
32 | | -* [PHP](https://www.php.net/) >= 8.2 |
33 | | -* [PHP curl extension](https://www.php.net/manual/en/book.curl.php) |
| 26 | +* [PHP](https://www.php.net/) >= 8.3 |
34 | 27 | * [Composer](https://getcomposer.org/) >= 2 |
35 | | -* [Nginx unit](https://unit.nginx.org/installation/) >= 1.30.0 |
36 | | - |
37 | | -### Installation |
38 | 28 |
|
39 | | -1. Create folder `mkdir example-php-project` |
40 | | -2. Open folder `cd example-php-project` |
41 | | -3. Crate composer.json file. Example below: |
42 | | -```json |
43 | | -{ |
44 | | - "name": "user/example-php-project", |
45 | | - "require": { |
46 | | - "pavlusha311245/unit-php-sdk": "^0.6.0" |
47 | | - }, |
48 | | - "autoload": { |
49 | | - "psr-4": { |
50 | | - "User\\ExamplePhpProject\\": "src/" |
51 | | - } |
52 | | - } |
53 | | -} |
54 | | - |
55 | | -``` |
56 | | -4. Install packages `composer install` |
| 29 | +### Supported Versions |
57 | 30 |
|
58 | | -Congratulations! You installed package. Now you can use the full power of this SDK. |
| 31 | +| Version | Nginx Unit Capability | Supported | |
| 32 | +|---------|:----------------------|--------------------| |
| 33 | +| 0.7.x | <= 1.32.1 | :white_check_mark: | |
| 34 | +| < 0.6.x | - | :x: | |
59 | 35 |
|
60 | | -* Create `src/index.php` file |
61 | | - 1. `cd src` (`mkdir src` if folder doesn't exist) |
62 | | - 2. `touch src/index.php` |
63 | | - 3. `nano src/index.php` |
64 | | -* Paste code and change this line `socket: <your socket path to Nginx Unit>` for your configuration |
| 36 | +### Quick start |
65 | 37 |
|
66 | | -```php |
67 | | -<?php |
| 38 | +How to start using the SDK in your project you can find in the [documentation](https://unit-sdk.pavlusha.me/installation). |
68 | 39 |
|
69 | | -use UnitPhpSdk\Unit; |
| 40 | +### Documentation |
70 | 41 |
|
71 | | -require '../vendor/autoload.php'; |
| 42 | +The Unit SDK offers a wide range of functionality. More examples and detailed information about its features, |
| 43 | +installation, and use can be found [in the documentation](https://unit-sdk.pavlusha.me/). Check it out to make the most |
| 44 | +of this extensive tool. Happy coding 😊 |
72 | 45 |
|
73 | | -$unit = new Unit( |
74 | | - socket: <your socket path to Nginx Unit>, |
75 | | - address: 'http://localhost' |
76 | | -); |
| 46 | +## Changelog |
77 | 47 |
|
78 | | -$unit->getConfig(); |
79 | | -``` |
| 48 | +We regularly update our code base due to new features, bug fixes or performance improvements. More information about |
| 49 | +these changes, including version details and update summaries, can be seen [here](CHANGELOG.md). |
80 | 50 |
|
81 | | -* Run `php index.php` |
| 51 | +## Contributing |
82 | 52 |
|
83 | | -### Documentation |
| 53 | +We appreciate all forms of contributions from code additions to reporting issues. Our project is open-source and thrives |
| 54 | +from the contributions made by our community. More info about how you can contribute to our project, contribution |
| 55 | +guidelines, and the whole process can be |
| 56 | +read [here](https://docs.github.com/en/get-started/quickstart/contributing-to-projects). |
84 | 57 |
|
85 | | -More examples and detailed information can be found [in the documentation](https://unit-sdk.pavlusha.me/) |
| 58 | +## Code of Conduct |
86 | 59 |
|
87 | | -Happy coding 😊 |
| 60 | +We want to create a welcoming environment for all of our projects. Our code of conduct outlines our expectations for all |
| 61 | +those who participate in our community, as well as the consequences for unacceptable behavior. We invite you to help us |
| 62 | +create a safe and positive experience for everyone. More info about our code of conduct can be |
| 63 | +found [here](.github/CODE_OF_CONDUCT.md). |
88 | 64 |
|
89 | | -## Changelog |
| 65 | +## Security Policy |
90 | 66 |
|
91 | | -More information about changes you can see [here](CHANGELOG.md) |
| 67 | +If you find bugs and vulnerabilities, please |
| 68 | +contact [unit@pavlusha.me](mailto:unit@pavlusha.me). |
92 | 69 |
|
93 | | -## Contribution |
| 70 | +More info [here](.github/SECURITY.md) |
94 | 71 |
|
95 | | -More info about contribution you can |
96 | | -read [here](https://docs.github.com/en/get-started/quickstart/contributing-to-projects) |
| 72 | +## Support |
97 | 73 |
|
98 | | -## Security Policy |
| 74 | +<div> |
| 75 | +<p>The project is being developed with the support of IDE from JetBrains</p> |
| 76 | + <img src="https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.svg" alt="JetBrains Logo (Main) logo."> |
| 77 | +</div> |
99 | 78 |
|
100 | | -If you find bugs and vulnerabilities, please |
101 | | -contact [unit@pavlusha.me](mailto:unit@pavlusha.me). |
| 79 | +## License |
102 | 80 |
|
103 | | -More info [here](SECURITY.md) |
| 81 | +This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details. |
0 commit comments