Download the PHP package finesse/micro-db without Composer

MicroDB

Like to use pure SQL but don't like to suffer from PDO, mysqli or etc.? Try this.

Key features:

• No silly query builder, only a good old SQL.
• Very light, no external dependencies. It required only the PDO extension which is available by default in most of servers.
• Database object is delivered explicitly, not through a static class.
• Exceptions on errors.

You can combine it with a third-party SQL query builder to rock the database. Examples of suitable query builders: Query Scribe, Nilportugues SQL Query Builder, Aura.SqlQuery, Latitude, Koine Query Builder, Phossa2 Query, Hydrahon.

Installation

Using Composer

Run in a console

Reference

Create a Connection instance

To create a new Connection instance call the create method passing PDO constructor arguments.

Or pass a PDO instance to the constructor. But be careful: Connection changes the given PDO object and you must not change the given object, otherwise something unexpected will happen.

Select

Select many rows:

Select one row:

The cell values are returned as they are returned by PDO. They are not casted automatically because casting can cause data loss.

Insert

Insert and get the number of the inserted rows:

Insert and get the identifier of the last inserted row:

Update

Update rows and get the number of the updated rows:

Delete

Delete rows and get the number of the deleted rows:

Other queries

Perform any other statement:

If the query contains multiple statements separated by a semicolon, only the first statement will be executed. You can execute multiple statements using the other method:

The lack of this method is that it doesn't take values to bind.

Execute a file

Execute the query from an SQL file:

Or from a resource:

Binding values

You should not insert values right to an SQL query because it can cause SQL injections. Instead use the binding:

Database server replaces the placeholders (?s) safely with the given values. Almost all the above methods accepts the list of the bound values as the second argument.

You can also use named parameters:

You can even pass named and anonymous parameters in the same array but it works only when the array of values has the same order as the placeholders in the query text.

All the scalar types of values are supported: string, integer, float, boolean and null.

Error handling

The Finesse\MicroDB\Exceptions\PDOException is thrown in case of every database query error. If an error is caused by an SQL query, the exception has the query text and bound values in the message. They are also available through the methods:

The Finesse\MicroDB\Exceptions\InvalidArgumentException is thrown when the method arguments have a wrong format.

The Finesse\MicroDB\Exceptions\FileException is thrown on a file read error.

All the exceptions implement Finesse\MicroDB\IException.

Retrieve the underlying PDO object

You must not change the retrieved object, otherwise something unexpected will happen.

Known problems

• insertGetId doesn't return the inserted row identifier for SQL Server and PostgreSQL.
• statements and import don't throw an exception if the second or a next statement of the query has an error. This is a PDO bug.

Make a pull request or an issue if you need a problem to be fixed.

Versions compatibility

The project follows the Semantic Versioning.

License

MIT. See the LICENSE file for details.