-
Notifications
You must be signed in to change notification settings - Fork 34
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #115 from utopia-php/docs-improve-readme
Docs: Improve readme
- Loading branch information
Showing
12 changed files
with
74 additions
and
113 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -2,19 +2,20 @@ | |
<img height="45" src="docs/logo.png" alt="Logo"> | ||
</p> | ||
|
||
[![Build Status](https://travis-ci.org/utopia-php/framework.svg?branch=master)](https://travis-ci.org/utopia-php/framework) | ||
![Total Downloads](https://img.shields.io/packagist/dt/utopia-php/framework.svg) | ||
[![Build Status](https://travis-ci.org/utopia-php/http.svg?branch=master)](https://travis-ci.org/utopia-php/http) | ||
![Total Downloads](https://img.shields.io/packagist/dt/utopia-php/http.svg) | ||
[![Discord](https://img.shields.io/discord/564160730845151244?label=discord)](https://discord.gg/GSeTUeA) | ||
|
||
Utopia Framework is a PHP MVC based framework with minimal must-have features for professional, simple, advanced and secure web development. This library is maintained by the [Appwrite team](https://appwrite.io). | ||
Utopia HTTP is a PHP MVC based framework with minimal must-have features for professional, simple, advanced and secure web development. This library is maintained by the [Appwrite team](https://appwrite.io). | ||
|
||
Utopia Framework is dependency-free. Any extra features, such as authentication or caching, will be available as standalone models in order to keep the framework core clean, light, and easy to learn. | ||
Utopia HTTP is dependency-free. Any extra features, such as authentication or caching are available as standalone models in order to keep the framework core clean, light, and easy to learn. | ||
|
||
## Getting Started | ||
|
||
Install using composer: | ||
Install using Composer: | ||
|
||
```bash | ||
composer require utopia-php/framework | ||
composer require utopia-php/http | ||
``` | ||
|
||
Init your first application in `src/server.php`: | ||
|
@@ -49,7 +50,7 @@ $http->start(); | |
Run HTTP server: | ||
|
||
```bash | ||
php -S localhost:8000 src/server2.php | ||
php -S localhost:8000 src/server.php | ||
``` | ||
|
||
Send HTTP request: | ||
|
@@ -60,7 +61,7 @@ curl http://localhost:8000/hello-world | |
|
||
### Server Adapters | ||
|
||
The library supports server adapters to be able to run on any PHP setup. For instance, you could use the FPM server or the Swoole server. | ||
The library supports server adapters to be able to run on any PHP setup. You could use the FPM or Swoole server. | ||
|
||
#### Use PHP FPM server | ||
|
||
|
@@ -203,7 +204,7 @@ Http::init() | |
}); | ||
``` | ||
|
||
Groups are designed to be actions that run during the lifecycle of requests to endpoints that have some logic in common. Groups allow you to prevent code duplication and are designed to be defined anywhere in your source code to allow flexibility. | ||
Groups are designed to be actions that run during the lifecycle of requests to endpoints that have some logic in common. Groups allow you to prevent code duplication and are designed to be defined anywhere in your source code to allow flexibility. | ||
|
||
### Resources | ||
|
||
|
@@ -243,17 +244,17 @@ In advanced scenarios, resources can also be injected into other resources or en | |
|
||
Resources are designed to prepare dependencies or context for the request. Resources are not meant to do functional logic or return callbacks. For such a use case, you should use hooks. | ||
|
||
To learn more about Framework architecture and features, check out more in-depth [Getting started guide](/docs/Getting-Starting-Guide.md). | ||
To learn more about architecture and features for this library, check out more in-depth [Getting started guide](/docs/Getting-Starting-Guide.md). | ||
|
||
## System Requirements | ||
|
||
Utopia Framework requires PHP 8.0 or later. We recommend using the latest PHP version whenever possible. | ||
Utopia HTTP requires PHP 8.1 or later. We recommend using the latest PHP version whenever possible. | ||
|
||
## More from Utopia | ||
|
||
Our ecosystem supports other thin PHP projects aiming to extend the core PHP Utopia framework. | ||
Our ecosystem supports other thin PHP projects aiming to extend the core PHP Utopia HTTP. | ||
|
||
Each project is focused on solving a single, very simple problem and you can use composer to include any of them in your next project. | ||
Each project is focused on solving a single, very simple problem and you can use composer to include any of them in your next project. | ||
|
||
You can find all libraries in [GitHub Utopia organization](https://github.com/utopia-php). | ||
|
||
|
@@ -263,7 +264,7 @@ All code contributions - including those of people having commit access - must g | |
|
||
Fork the project, create a feature branch, and send us a pull request. | ||
|
||
You can refer to the [Contributing Guide](https://github.com/utopia-php/framework/blob/master/CONTRIBUTING.md) for more info. | ||
You can refer to the [Contributing Guide](https://github.com/utopia-php/http/blob/master/CONTRIBUTING.md) for more info. | ||
|
||
For security issues, please email [email protected] instead of posting a public issue in GitHub. | ||
|
||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
Oops, something went wrong.