dframe / database

Database class using PDO with query and whereChunk builder.

Dframe - PHP Framework

The basic framework to help you build MVC project.

• Requirements
• Installation
• Documentation
• Overview
  • Good Practice
• Extensions
  • Router
  • Session
• License

What's included?

• Class Loader PHP
• Router PHP
• Template PHP
• Cron PHP

Requirements

• PHP >= 8.1
• Rewrite Module (Nginx/Apache )
• Composer

Installation

Framework Core

$ composer require dframe/dframe

Demo skeleton project

$ composer create-project dframe/dframe-demo project_name

License

Open-sourced software licensed under the MIT license

database's Issues

Duplicate comment

Refactory code

Refactory code. Update phpdoc, clean code.

Undefined variables

_bindPdoParam NULL typing capabilities

Wrong code qualification

Repo qualification as TSQL code

Allow other operators

Allow in prepareQuery other operator for example "CREATE TABLE IF NOT EXISTS "

Native dsn

Before

    $dbConfig = [
        'host' => DB_HOST,
        'dbname' => DB_DATABASE,
        'username' => DB_USER,
        'password' => DB_PASS
    ];
    
    // Debug Config 
    $config = [
        'logDir' => APP_DIR . 'View/logs/',
        'attributes' => [
            PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8", 
            //PDO::ATTR_ERRMODE => PDO::ERRMODE_SILENT,  // Set pdo error mode silent
            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, // If you want to Show Class exceptions on Screen, Uncomment below code 
            PDO::ATTR_EMULATE_PREPARES => true, // Use this setting to force PDO to either always emulate prepared statements (if TRUE), or to try to use native prepared statements (if FALSE). 
            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC // Set default pdo fetch mode as fetch assoc
         ]
    ];
    $db = new Database($dbConfig, $config);

After Example 1

    // Debug Config 
    $config = [
        'logDir' => APP_DIR . 'View/logs/',
        'attributes' => [
            PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8", 
            //PDO::ATTR_ERRMODE => PDO::ERRMODE_SILENT,  // Set pdo error mode silent
            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, // If you want to Show Class exceptions on Screen, Uncomment below code 
            PDO::ATTR_EMULATE_PREPARES => true, // Use this setting to force PDO to either always emulate prepared statements (if TRUE), or to try to use native prepared statements (if FALSE). 
            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC // Set default pdo fetch mode as fetch assoc
         ]
    ];
    
    $dsn = [
        'host' => DB_HOST,
        'dbname' => DB_DATABASE,
        'dbtype' => 'mysql'
    ];
        
    $db = new Database($dsn, DB_USER, DB_PASS, $config);

After Example 2

  // Debug Config 
    $config = [
        'log_dir' => APP_DIR . 'View/logs/',
        'attributes' => [
            PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8", 
            //PDO::ATTR_ERRMODE => PDO::ERRMODE_SILENT,  // Set pdo error mode silent
            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, // If you want to Show Class exceptions on Screen, Uncomment below code 
            PDO::ATTR_EMULATE_PREPARES => true, // Use this setting to force PDO to either always emulate prepared statements (if TRUE), or to try to use native prepared statements (if FALSE). 
            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC // Set default pdo fetch mode as fetch assoc
         ]
    ];
    
    $db = new Database('mysql:host='.DB_HOST.';dbname=' . DB_DATABASE . ';port=3306', DB_USER, DB_PASS, $config);
   

PHPUnit - Failed asserting that exception of type "PDOException" is thrown.

There was 1 failure:

1. Dframe\Database\Tests\ConnectionTest::testEmptyPdoQuery
   Failed asserting that exception of type "PDOException" is thrown.

https://travis-ci.org/dframe/database/jobs/430181128

Update phpdocs and remove unused property

Update phpdocs and remove unused property

Undefined Exceptions

Undefined Exceptions

Add missing getter for PDOStatement

Update phpunit test

Add composer require-dev phpunit and updates tests

No need for underscores for private methods

No need for underscores for private methods. These are a relic of PHP 4 when there was no method.

Insert Batch Helper

More flexible config

Movie attributes to config

Wrong order parametr LIMIT

Describe the bug
Parameters are the opposite

 public function prepareLimit($limit, $offset = null)
    {
        if ($offset) {
            $this->setLimit = ' LIMIT ' . $limit . ', ' . $offset . '';
        } else {
            $this->setLimit = ' LIMIT ' . $limit . '';
        }

        return $this;
    }

Should be

    public function prepareLimit($limit, $offset = null)
    {
        if ($offset) {
            $this->setLimit = ' LIMIT ' . $offset . ', ' . $limit . '';
        } else {
            $this->setLimit = ' LIMIT ' . $limit . '';
        }

        return $this;
    }

Update PSR-12

Replaces array() with []. feature

Use [] instead of array(). It is shorthand, looks better, and is the standard way of instantiating new arrays.

Get rid of Hungarian notation

Update phpdoc

Fix commnets

update config .travis.yml

Update .travis.yml

before

script: phpunit

after

script:
  - vendor/bin/phpunit

Update __construct

Before

public function __construct($dsn, $username, $password, $config = ['logDir' => '', 'attributes' => []])

After

<?php
public function __construct($dsn, $username, $password, $config = ['logDir' => '', 'options' => []])

Update phpdoc

Update phpdoc

params in isset() always exists and is not nullable

Incorrect order Having

Before

    /**
     * GetQuery function.
     *
     * @return string
     */
    public function getQuery()
    {
        $sql = $this->setQuery;
        $sql .= $this->getWhere();
        $sql .= $this->getGroupBy();
        $sql .= $this->getOrderBy();
        $sql .= $this->getHaving();
        $sql .= $this->getLimit();

        $this->setQuery = null;
        $this->setWhere = null;
        $this->setHaving = null;
        $this->setOrderBy = null;
        $this->setGroupBy = null;
        $this->setLimit = null;

After

    /**
     * GetQuery function.
     *
     * @return string
     */
    public function getQuery()
    {
        $sql = $this->setQuery;
        $sql .= $this->getWhere();
        $sql .= $this->getGroupBy();
        $sql .= $this->getHaving();
        $sql .= $this->getOrderBy();
        $sql .= $this->getLimit();

        $this->setQuery = null;
        $this->setWhere = null;
        $this->setGroupBy = null;
        $this->setHaving = null;
        $this->setOrderBy = null;
        $this->setLimit = null;

Add Exceptions

PDO::ATTR_EMULATE_PREPARES should be false

According to the official PHP doc, the PDO::ATTR_EMULATE_PREPARES attribute should be set the false because it should use the native prepared statement. The MySQL supports the native prepared statement.

Add Chunk Interface

Argument of an invalid type

minimum-stability

Change composer.json

minimum-stability dev
prefer-stable true