步骤 1：设置应用程序数据库
使用下列 MySQL 表定义和示例数据设置应用程序数据库。
如果您只在本地进行开发和部署，那么可以使用这种方法针对要连接的 API 初始化 MySQL 数据库表。
如果在 Bluemix 上进行部署，那么暂时可以跳过这一步；完成了步骤 7 在 Bluemix 上初始化和绑定 MySQL 服务实例后，再返回到这一步。
CREATE TABLE IF NOT EXISTS `products` (
`id` int(10) unsigned NOT NULL AUTO_INCREMENT,
`name` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
`price` decimal(5,2) NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci;
INSERT INTO `products` (`id`, `name`, `price`) VALUES
(1, 'Garden spade', 15.99),
(2, 'Cotton hammock', 54.50),
(3, 'Single airbed', 35.49);
回页首
步骤 2：安装 Bullet 和 Eloquent
下一步是下载并设置 Bullet 微型框架。为什么要使用 Bullet 呢？因为它包含一个灵活的 URL 路由器，可以轻松地在自定义 URL 上创建和响应不同的 HTTP 方法，它还包含一个嵌套路由回调，可以简化常见重复任务（比如 API 身份验证）的执行。
为了简化数据库访问，我将使用 Eloquent，这是一个受欢迎的对象关系映射器（Object Relational Mapper，ORM），它使用 ActiveRecord 实现来简化数据库记录的使用。Eloquent 是 Laravel PHP 框架的一部分，但它也可以单独使用。
我将使用 Composer（PHP 依赖关系管理器）来下载和设置 Bullet 与 Eloquent。下面是 Composer 配置文件，可以将它保存到 $APP_ROOT/composer.json。在本文中，$APP_ROOT 指应用程序工作目录。
{
"require": {
"vlucas/bulletphp": "*",
"illuminate/database": "*"
}
}
现在，可以使用 Composer 的下列命令安装 Bullet 和 Eloquent：
shell> php composer.phar install
为了简化应用程序访问，还可以在开发环境中定义新的虚拟主机，并将其文档根目录指定为 $APP_ROOT。尽管此步骤是可选的，但建议使用它，因为它在 Bluemix 上创建了一个更接近目标部署环境的副本。
要在 Apache 中为应用程序设置一个命名的虚拟主机，请打开 Apache 配置文件（httpd.conf 或 httpd-vhosts.conf）并添加下列行。
NameVirtualHost 127.0.0.1
<VirtualHost 127.0.0.1>
DocumentRoot "/usr/local/apache/htdocs/api"
ServerName api.localhost
</VirtualHost>
要在 nginx 中为应用程序设置一个命名的虚拟主机，请打开 nginx 配置文件 (nginx.conf) 并添加下列行。
server {
server_name api.localhost;
root /usr/local/apache/htdocs/api;
try_files $uri /index.php;
location ~ \.php$ {
try_files $uri =404;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
# assumes you are using php-fcgi
fastcgi_pass 127.0.0.1:90;
}
}
这些行定义一个新的虚拟主机，http://api.localhost/，它的文档根目录对应于 $APP_ROOT 目录（记住更新此目录以反映您自己的本地设置）。重启 Web 服务器以激活这些新的设置。请注意，您可能需要更新网络的本地 DNS 服务器，让它知道新的主机。
回页首
步骤 3：处理资源集合的 GET 请求
Bullet 每次解析一个 URL 段并使用回调响应特定的路径或参数模式。可以在每个 HTTP 方法上定义回调，这允许您对 GET 请求而不是 POST 请求执行不同的操作。
典型的 REST API 支持两种 GET 请求：第一种请求针对资源集合 (GET /products) ，而第二种请求针对具体资源 (GET /products/123)。首先编写代码来处理第一种场景：使用数据库的所有可用产品列表响应 GET /products 请求。使用下列代码更新 $APP_ROOT/index.php 文件。
<?php
// set up Composer autoloader
require __DIR__ . '/vendor/autoload.php';
// initialize application
$app = new Bullet\App();
$app->path('v1', function($request) use ($app) {
$app->path('products', function($request) use ($app) {
// GET /v1/products
// list all products
$app->get(function() use ($app) {
$products = Product::all();
return $products->toArray();
});
});
});
echo $app->run(new Bullet\Request());
第一步是初始化 Composer 自动加载器，它负责根据需要加载所需的类。然后，创建一个新的 Bullet\App 对象来表示应用程序，并使用此应用程序对象的 path() 方法来设置端点 /v1/products 的嵌套 URL 路径。最里面的 path() 回调定义此端点支持的方法 — 在本例中，使用应用程序对象的 get() 方法来定义 GET 请求的处理程序。
路由处理程序使用 Eloquent 模型返回数据库的所有产品。由于此处理程序返回的是一个数组，因此 Bullet 自动假设响应格式应该是 JSON，使用 'Content-Type: application/json' 标头和 200 OK 成功代码来转换此数组，并将它发送回客户端。如果有任何错误，异常处理程序会捕捉错误，并使用 500 Internal Server Error 和一个包含错误消息的 JSON 正文将错误返回给客户端。
当收到传入请求时，通过执行 Bullet 应用程序，应用程序对象的 run() 方法（如上一个清单的最后一行所示）将所有内容聚集在一起。
此时，您可能会认为这一切都是有意义的，除了一个问题：此 Eloquent 模型来自何处？下一个清单会将会说明这一点，使用 GET 处理程序添加使用 Eloquent 所需的代码，如上所述。
<?php
// set up Composer autoloader
require __DIR__ . '/vendor/autoload.php';
// use Eloquent ORM
use Illuminate\Database\Capsule\Manager as Capsule;
use Illuminate\Database\Schema\Blueprint as Schema;
// create model for Eloquent ORM mapped to REST API resource
class Product extends Illuminate\Database\Eloquent\Model {
public $timestamps = false;
}
// get MySQL service configuration from Bluemix
$services = getenv("VCAP_SERVICES");
$services_json = json_decode($services, true);
$mysql_config = $services_json["mysql-5.5"][0]["credentials"];
$db = $mysql_config["name"];
$host = $mysql_config["host"];
$port = $mysql_config["port"];
$username = $mysql_config["user"];
$password = $mysql_config["password"];
// initialize Eloquent ORM
$capsule = new Capsule;
$capsule->addConnection(array(
'driver' => 'mysql',
'host' => $host,
'port' => $port,
'database' => $db,
'username' => $username,
'password' => $password,
'charset' => 'utf8',
'collation' => 'utf8_unicode_ci',
'prefix' => ''
));
$capsule->setAsGlobal();
$capsule->bootEloquent();
// initialize application
$app = new Bullet\App();
$app->path('v1', function($request) use ($app) {
$app->path('products', function($request) use ($app) {
// GET /v1/products
// list all products
$app->get(function() use ($app) {
$products = Product::all();
return $products->toArray();
});
});
});
echo $app->run(new Bullet\Request());
Eloquent 随附提供了一个 Capsule 管理器实例，旨在简化 Laravel 外部的 Eloquent 使用。上一个清单演示了实际的 Capsule 实例，建立了一个到 MySQL 数据库的新连接，并使 Capsule 实例在全局可用。
由于本文的最终目的是将应用程序部署到 Bluemix，因此会从特殊的 Bluemix VCAP_SERVICES 环境变量提取 MySQL 连接的凭据；但是，如果您打算在本地进行部署，那么可以使用特定于本地数据库服务器的值取代这些值。
您还会注意到扩展 Illuminate\Database\Eloquent\Model 类的 Product 模型。此 Product 模型提供了许多预定义的方法，可以简化相应数据库记录的使用。您已经看到了其中的一个实际方法 —Product::all()—，它负责在内部生成对 "return all products in the database" 的 SELECT 查询。