版本: 1.1.3
开始
使用 Medoo 是非常容易的事!
需求
- PHP 5.1+, 推荐 PHP 5.4+， PDO 支持。
- 已安装有 MySQL, MSSQL, SQLite 或其它的数据库。
- 确保 php_pdo_xxx 已经安装并是启用状态。
- 需要懂一些 SQL 知识。
小提示
在 PHP 5.4+ 中, 你可以使用 [] 作为数组语法。所有的 Medoo 示例都使用 [] 代替 array()。
// 在 PHP 5.1 中
$data = array("foo", "bar");
// 在 PHP 5.4+ 中
$data = ["foo", "bar"];
php_pdo 扩展列表
- MySQL, MariaDB -> php_pdo_mysql
- MSSQL (Windows) -> php_pdo_sqlsrv
- MSSQL (Linux/UNIX) -> php_pdo_dblib
- Oracle -> php_pdo_oci
- SQLite -> php_pdo_sqlite
- PostgreSQL -> php_pdo_pgsql
- Sybase -> php_pdo_dblib
PHP PDO 驱动安装
Medoo 需要 PHP 支持 PDO 。如果你之前没有安装，按照以下步骤安装：
// 打开 php.ini ，在想要安装的数据库扩展中去掉 ';' 。 // 安装之前 ;extension=php_pdo_mysql.dll // 安装之后 extension=php_pdo_mysql.dll // 保存, 并重启 PHP 或 Apache 服务器。 // 如果 PDO 安装成功，你将在 phpinfo() 中看到 。
或可通过终端 (terminal) 安装。PDO_XXX 将会自动启用和配置。
$ sudo apt-get install php5-mysql
通过 Composer 安装
如果你了解 composer，将非常容易安装和管理版本依赖。只需使用以下命令添加 Medoo 到 composer.json 中。或者你可以直接编辑它，这取决于你。
$ composer require catfan/Medoo
更新 composer
$ composer update
通过下载安装
这是最简单的方式。只需下载 medoo.php 并放到合适的目录中，然后 require，之后就可以开始使用了!
require 'medoo.php';
配置
有三种方式来配置 medoo 和启动一个数据库连接。
// 如果你通过 composer 安装, 只需在项目的开始部分加上此代码即可自动加载。
require 'vendor/autoload.php';
// 或者你是下载 medoo.php 并放置到项目目录中，require 即可。
require 'medoo.php';
$database = new medoo([
// 必须的
'database_type' => 'mysql',
'database_name' => 'name',
'server' => 'localhost',
'username' => 'your_username',
'password' => 'your_password',
'charset' => 'utf8',
// [可选]
'port' => 3306,
// [可选] 表名前缀
'prefix' => 'PREFIX_',
// [可选] 连接的驱动选项，请阅读 http://www.php.net/manual/en/pdo.setattribute.php
'option' => [
PDO::ATTR_CASE => PDO::CASE_NATURAL
]
]);
$database->insert("account", [
"user_name" => "foo",
"email" => "foo@bar.com"
]);
For MSSQL
如果你要在 PHP 中使用 Medoo 连接 MSSQL，需要安装 PHP 扩展，Windows 中为 pdo_sqlsrv ，Linux/UNIX 中为 pdo_dblib 。PHP 已经弃用 pdo_mssql 扩展了，并准备移除。
For SQLite
$database = new medoo([
'database_type' => 'sqlite',
'database_file' => 'my/database/path/database.db'
]);
$database->insert("account", [
"user_name" => "foo",
"email" => "foo@bar.com"
]);