# air

**Repository Path**: mirrors_sudoconf/air

## Basic Information

- **Project Name**: air
- **Description**: a high performance, light weight framework for php5 & php7 written in c
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-26
- **Last Updated**: 2025-11-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# air framework

一款使用 `C` 语言写成的、现代的、高性能轻量级的`PHP` `web`框架。

> see [README_en.md](README_en.md) for english introduction.

## 特性

### 1. 高性能、轻量级

在所有`PHP``web`框架的对比测试中，**`air framework`** 在并发数(QPS)、CPU及内存占用等多方面评价指标上均以显著的优势领先于其他框架。

### 2. 高效的`MVC`机制

简单可扩展的`MVC`机制，高效灵活的路由功能，帮助开发者快速高效搭建从个人到企业、从简单到复杂，各种类型、各种规模的`web`站点。

传统框架需要几到几十毫秒才能完成的核心模块加载流程，使用本框架仅需微秒级别时间即可极速完成。

### 3. 强大的异步并发能力

在实际的`web`应用中，整个请求流程中业务逻辑（主要是同步阻塞的数据库查询和远程API访问）耗时往往远远大于核心模块的加载耗时。

**`air framework`** 从设计之初即着眼于解决实际困难，独创 `request/waiter/service` 异步并发请求模式，同时提供强大的数据库异步并发查询和远程HTTP异步并发请求两大特性，帮助开发者在这两大主要耗时场景中轻松获得数倍乃至数十倍的速度提升，从而使整个应用的运行性能得到真正的质的提升。

#### 3.1 异步并发的数据库查询

```php
<?php
/**
 * air\config::path_get('mysql.config.air');
 * @see https://github.com/wukezhan/air/blob/master/tests/mysqli.inc.php
 * @see https://github.com/wukezhan/air/blob/master/tests/004.mysql.phpt
 */
$b1 = new air\mysql\builder('mysql.config.air');
$b2 = new air\mysql\builder('mysql.config.air');
$b3 = new air\mysql\builder('mysql.config.air');
$start = time();
$b1->async()->query('SELECT 1 AS a, sleep(1) AS b');
$b2->async()->query('SELECT 2 AS a, sleep(1) AS b');
$b3->async()->query('SELECT 3 AS a, sleep(1) AS b');
// really start all the async queries
var_dump($b1->data()); // or var_dump($b[0]); // or foreach($b as $k=>$v){...}
var_dump($b2->data());
var_dump($b3->data());
// will totally use 1 second but not 3 seconds
echo time()-$start, "\n";
```

#### 3.2 异步并发的远程HTTP请求

```php
<?php
/**
 * @see https://github.com/wukezhan/air/blob/master/tests/server.inc.php
 * @see https://github.com/wukezhan/air/blob/master/tests/003.curl.phpt
 */
function data2arr($ch, $data){
    return json_decode($data, 1);
}

$c1 = new air\curl();
$c1->async();
$c1->setopt(CURLOPT_RETURNTRANSFER, 1);
$c1->get(local_server::$host_port . '/get.php?hello=world-1');

$c2 = new air\curl();
$c2->async()
    ->setopt(CURLOPT_RETURNTRANSFER, 1)
    ->get(local_server::$host_port . '/json.php?hello=world-2')
    ->on_success('data2arr')
;

echo $c1->data();
var_dump($c2->data());
```

### 4. 先进的代码组织理念

默认基于命名空间的自动加载机制，让应用几乎不需要任何显式的配置，即可实现全部代码的自动加载。

而通过对路由、配置的灵活设置，可以实现几乎任意复杂度的`web`应用的代码组织和构建。

## 安装

### 环境要求

* Linux
* PHP 5.4+
    * mysqlnd
    * mysqli
    * curl

```sh
# configure options
./configure --prefix=/path/to/php --enable-mysqlnd --with-mysqli --with-curl
```

### 安装步骤

- 从源码安装

```sh
# 1. 准备源码
## 下载并解压缩源码包
### php5
https://github.com/wukezhan/air/archive/master.zip
### php7
https://github.com/wukezhan/air/archive/php7.zip
### 或从源码克隆
git clone https://github.com/wukezhan/air

cd air
# 对于克隆源码，可执行以下命令切换到 php7 分支
git checkout php7

# 2. 编译安装
/path/to/php/bin/phpize
./configure --with-php-config=/path/to/php/bin/php-config
make && make install
make test

# 3. 修改配置
vim /path/to/php/lib/php.ini
增加以下配置：
extension = air.so
```

## 更多

* **[快速开始](hello-world/README.md)**
* **实例**
	* [hello-world](hello-world) 入门演示实例
	* [docker-ui](https://github.com/wukezhan/docker-ui) 一个简单的docker管理界面
	* [tests](tests) 测试实例
* **文档**
	* [接口文档](helper/doc.md)
	* [air-book](http://air.wukezhan.com) [预备中]
	* [代码补全 & 函数原型](helper/air.php)

## 关于

对本项目感兴趣的朋友，可以关注微博 [weibo.com/wukezhan](http://weibo.com/wukezhan) 或通过以下方式与我进行联系和交流：

* blog: [www.wukezhan.com](http://www.wukezhan.com)
* twitter: [wukezhan](https://twitter.com/wukezhan)
* github: [wukezhan/air](https://github.com/wukezhan/air)