README

要求

1. MySQL 5.5 或更高版本。
2. PHP 5.4 或更高版本。

安装

使用以下命令安装最新版本：

$ composer require jrdev/mysql

如何使用

首先，连接到数据库

$db = new \jrdev\MySQL('host', 'user', 'pass', 'database');

然后，准备你的数据，并调用必要的方法。

通用查询方法

此方法仅接受一个参数，即要执行的 SQL。
并返回一个 jrdev\MySQL\Result 对象。

$query = $db->query('SELECT ...');

SELECT 语句

此方法接受

1. tableName: 表名。
2. fields: (可选) 你想要在结果中获取的字段。接受数组或字符串
3. where: (可选) WHERE 条件。接受数组、字符串或整数
4. orderBy (可选) ORDER BY。
5. limit (可选) LIMIT。

返回一个 jrdev\MySQL\Result 对象。

$query = $db->select('table_name', 'field1, field2');

if ($query)
{
    echo 'Num Rows: ', $query->num_rows, '<br>';

    foreach ($query as $row) 
    {
        echo $row['first_name'], '<br>';
    }
}
else
{
    echo $db->error();
}

// The $where (third param) accepts array, string or integer:
$query = $db->select('table_name', 'field1', ['name' => 'Pepe']); // With array.
$query = $db->select('table_name', 'field1', 'name = "Pepe"'); // With string.
$query = $db->select('table_name', 'field1', 1); // With integer. In this case, the resulting sql for the "WHERE" is "id = 1".

INSERT 语句

此方法接受

1. tableName: 表名。
2. fields: 你想要插入的字段。

返回插入行的 ID，或出错时返回 FALSE。

$inserted_id = $db->insert('table_name', [
    'field1' => 'Value 1',
    'field2' => 2,
]);

UPDATE 语句

此方法接受

1. tableName: 表名。
2. fields: 要更新的字段。
3. where: WHERE 条件。接受数组、字符串或整数。
4. limit (可选) 要更新的行数限制。

返回受影响的行数，或出错时返回 FALSE。

// NOTE: The $where (third param) like the select method accepts array, string or integer.

$row = [
    'field1' => 'Value',
];

$updated_rows = $db->update('table_name', $row, ['id' => 58]); // With array.
$updated_rows = $db->update('table_name', $row, 'id=58'); // With string.
$updated_rows = $db->update('table_name', $row, 58); // With integer.

DELETE 语句

此方法接受

1. tableName: 表名。
2. where: WHERE 条件。接受数组、字符串或整数。
3. limit (可选) 要删除的行数限制。

返回受影响的行数，或出错时返回 FALSE。

// NOTE: The $where (second param) like the select method accepts array, string or integer.

$deleted_rows = $db->delete('table_name', ['id' => 58]); // With array.
$deleted_rows = $db->delete('table_name', 'id=58'); // With string.
$deleted_rows = $db->delete('table_name', 58); // With integer.

许可

在 MIT 许可证 下授权。