https://github.com/bitendian/tbp
Light framed PHP library
https://github.com/bitendian/tbp
component-architecture composer-package light-framework php-framework
Last synced: about 1 year ago
JSON representation
Light framed PHP library
- Host: GitHub
- URL: https://github.com/bitendian/tbp
- Owner: Bitendian
- License: apache-2.0
- Created: 2017-05-11T14:05:00.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2022-10-14T11:18:34.000Z (over 3 years ago)
- Last Synced: 2025-04-11T06:11:24.678Z (about 1 year ago)
- Topics: component-architecture, composer-package, light-framework, php-framework
- Language: PHP
- Homepage: http://www.bitendian.com/en/portfolio/tbp-5/
- Size: 1.04 MB
- Stars: 2
- Watchers: 4
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TBP
*TBP* is a light framework designed to develop small and medium
websites. Focused in component oriented
## Database interfaces
### SQLite
Connector to SQLite3. Works with prepared statements (mandatory). Support for transactions.
#### Installation
PHP extension ```ext-sqlite3``` required. Check ```phpinfo()```. By default, ```tbp-web-server``` Docker image supports SQLite.
Add to your ```composer.json```, at ```require``` section:
```
"ext-sqlite3": "*"
```
#### Configuration
Create a config file, like ```config/my-sqlite.config```
```
# TBP/SQLite config file.
# ALL PARAMETERS ARE OPTIONAL!
# Database file name (if not defined, will use 'default.db')
filename=resources/test.db
# Access type
# readOnly=yes
# Encryption key (if not defined, no encryption used)
# encryptionKey=
```
#### Implementation
Create a *Domain* extending ```AbstractSqliteDomain``` and pass your config file. Add one method for each needed query.
```php
class MyDomain extends AbstractSqliteDomain
{
public function __construct()
{
$configReader = new Config(__CONFIG_PATH__); // <-- get a config reader, passing your config folder
$config = $configReader->getConfig('my-sqlite'); // <-- read your configuration, passing your config base name
$config->filename = // <-- convert your relative path into absolute path
__BASE_PATH__ .
DIRECTORY_SEPARATOR .
$config->filename;
parent::__construct($config);
$this->open(); // <-- open a db connection and let's rock!
}
public function addRegister($a, $b)
{
$sql = "INSERT INTO `MyTableWithAutoInc` (`a`, `b`) VALUES (?, ?)";
$params = array($a, $b);
return self::insertWithAutoincrement($this->connection->command($sql, $params));
}
public function addAnotherRegister($a, $b)
{
$sql = "INSERT INTO `MyOtherTable` (`a`, `b`) VALUES (?, ?)";
$params = array($a, $b);
return $this->connection->command($sql, $params);
}
public function getRegisters($b)
{
$sql = "SELECT * FROM `MyTableWithAutoInc` WHERE `b` <= ?";
$params = array($b);
return self::getAll($this->connection->select($sql, $params));
}
public function getRegisterById($id)
{
$sql = "SELECT * FROM `MyTableWithAutoInc` WHERE `MyId` = ?";
$params = array($id);
return self::getSingle($this->connection->select($sql, $params));
}
}
```
#### Usage
sample straight-forward code:
```php
$domain = new MyDomain();
$results = $domain->getRegisters(9391); // get an array
```
sample code with transactions:
```php
$domain = new MyDomain();
try {
$domain->begin();
$lastId = $domain->addRegister(1, 2);
echo "first query: last inserted id: $lastId\n";
$lastId = $domain->addRegister(3, 4);
echo "second query: last inserted id: $lastId\n";
$domain->commit();
} catch (Exception $e) {
$domain->rollback();
echo "ERROR: " . $e->getMessage() . "\n";
}
```