{"id":15296249,"url":"https://github.com/catsand/pdo-database-wrapper","last_synced_at":"2025-10-07T08:31:00.220Z","repository":{"id":56974465,"uuid":"65831567","full_name":"catsAND/PDO-Database-Wrapper","owner":"catsAND","description":"PDO wrapper with easy syntax for fast development :+1:","archived":true,"fork":false,"pushed_at":"2016-09-27T15:41:26.000Z","size":13,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-08T21:18:08.719Z","etag":null,"topics":["mysql","pdo","pdo-wrapper","php","php5","simple-mysql"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/catsAND.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-08-16T15:27:45.000Z","updated_at":"2023-01-28T15:57:25.000Z","dependencies_parsed_at":"2022-08-21T07:40:32.136Z","dependency_job_id":null,"html_url":"https://github.com/catsAND/PDO-Database-Wrapper","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/catsAND/PDO-Database-Wrapper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catsAND%2FPDO-Database-Wrapper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catsAND%2FPDO-Database-Wrapper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catsAND%2FPDO-Database-Wrapper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catsAND%2FPDO-Database-Wrapper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/catsAND","download_url":"https://codeload.github.com/catsAND/PDO-Database-Wrapper/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catsAND%2FPDO-Database-Wrapper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278743013,"owners_count":26037951,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mysql","pdo","pdo-wrapper","php","php5","simple-mysql"],"created_at":"2024-09-30T18:09:50.650Z","updated_at":"2025-10-07T08:30:59.946Z","avatar_url":"https://github.com/catsAND.png","language":"PHP","readme":"# PDO Database Wrapper\nSimple PDO Wrapper with named and question mark placeholders for easy and fast development. Try it!\n\n## Requirements\n\n* PHP 5.3 or greater\n* PDO extension\n\n## Instalation\n\n### Download the files.\n\n* You can [download](https://github.com/catsAND/PDO-Database-Wrapper/archive/v1.0.zip) them directly \nand extract them to your web directory.\n\n### [Composer](https://getcomposer.org)\n\n* `composer require catsand/pdo-database-wrapper` \n\n### Clone the repo\n\n* `git clone https://github.com/catsAND/PDO-Database-Wrapper.git`\n\n## Features\n\n  * Simple syntax.\n  * Question mark placeholders with types.\n  * Named placeholders.\n\n## Functions\n\n### List\n```php\npublic query($sql, ...value)\n\npublic select($sql, ...value)\n\npublic selectCell($sql, ...value);\npublic column($sql, ...value);\npublic cell($sql, ...value);\n\npublic selectRow($sql, ...value);\npublic fetch($sql, ...value);\npublic row($sql, ...value);\n\npublic selectArray($sql, ...value);\n\npublic selectHash($sql, ...value);\npublic hash($sql, ...value);\n\npublic insert($tableName, $valueArray, $columnsArray = array);\npublic insertIgnore($tableName, $valueArray, $columnsArray = array);\npublic replace($tableName, $valueArray, $columnsArray = array);\n\npublic getLastId();\npublic lastId();\n\npublic getRowCount();\n\npublic beginTransaction();\npublic start();\n\npublic executeTransaction();\npublic finish();\npublic commit();\n\npublic rollBack();\npublic cancel();\n\npublic lock($tableNames);\n\npublic unlock();\n```\n\n* query\n\n```php\npublic query($sql, ...value)\n```\nReturn number of affected rows\n\n\n* select\n\n```php\npublic select($sql, ...value)\n```\nReturn array with results\n\n* selectCell\n\n```php\npublic selectCell($sql, ...value);\n```\nReturn string with first column value from first row\n\n* selectRow\n\n```php\npublic selectRow($sql, ...value);\n```\nReturn array with all columns from first row\n\n* selectArray\n\n```php\npublic selectArray($sql, ...value);\n```\nReturn array with first columns from rows as value\n\n\n* selectHash\n\n```php\npublic selectHash($sql, ...value);\n```\nReturn array with first columns from rows as key and second columns from rows as value\n\n* insert, insertIgnore, replace\n\n```php\npublic insert($tableName, $valueArray, $columnsArray = array);\npublic insertIgnore($tableName, $valueArray, $columnsArray = array);\npublic replace($tableName, $valueArray, $columnsArray = array);\n```\n\nReturn numbers of affected rows\n\n**Column names obligatory need to be in $valueArray first array as key or in $columnsArray array as value.**\n\n### Examples\n\n```php\n  $db = new Database\\Database('localhost', 'dbname', 'user', 'password');\n  $result = $db-\u003eselect('SELECT COLUMN1, COLUMN2, COLUMN3 FROM `table_name` WHERE COLUMN4 = ?s AND COLUMN5 = ?i OR COLUMN6 = ?', 'column4', 5, 'column6');\n```\n\n```php\n $db-\u003einsert('table_name', array(array('COLUMN1' =\u003e 123, 'COLUMN2' =\u003e 123), array(234, 234), array(345, 345), array(456, 456)));\n $db-\u003einsert('table_name', array(123, 123));\n $db-\u003einsertIgnore('table_name', array(array(123, 123), array(234, 234), array(345, 345), array(456, 456)), array('COLUMN1', 'COLUMN2'));\n $db-\u003ereplace('table_name', array(123, 123), array('COLUMN1', 'COLUMN2'));\n```\n\n### Avalaible placeholders:\n\n**? — bind value with autotype**\n\n```php\nselect('SELECT * FROM `table_name` WHERE `COLUMN1` = ? OR `COLUMN2` = ?', 'VALUE', 5);\n```\n```sql\nSELECT * FROM `table_name` WHERE `COLUMN1` = 'VALUE' OR `COLUMN2` = 5;\n```\n\n**?r — bind raw value to SQL query without verification**\n\n```php\nselect('SELECT * FROM ?r WHERE `?r` \u003e 1', '`table_name`', 'COLUMN');\n```\n```sql\nSELECT * FROM `table_name` WHERE `COLUMN` \u003e 1;\n```\n\n**?i — bind value as integer**\n\n```php\nselect('SELECT * FROM `table_name` WHERE `COLUMN` = ?i', 23);\n```\n```sql\nSELECT * FROM `table_name` WHERE `COLUMN` = 23;\n```\n\n**?s — bind value as string**\n\n```php\nselect('SELECT * FROM `table_name` WHERE `COLUMN` = ?s', 'string');\n```\n```sql\nSELECT * FROM `table_name` WHERE `COLUMN` = 'string';\n```\n\n**?f — bind value as float**\n\n```php\nselect('SELECT * FROM `table_name` WHERE `COLUMN` = ?f OR `COLUMN` = ?f', 3.1415926535, '2.71828');\n```\n```sql\nSELECT * FROM `table_name` WHERE `COLUMN` = '3.1415926535' OR `COLUMN` = '2.71828';\n```\n\n**?b — bind value as boolean**\n\n**?n — bind value as null**\n\n\n**?q — bind value as string without HTML tags**\n\n```php\nselect('SELECT * FROM `table_name` WHERE `COLUMN` = ?s', 'string');\n```\n```sql\nSELECT * FROM `table_name` WHERE `COLUMN` = 'string';\n```\n\n**?a — bind value as integer array.**\n\n```php\nselect('SELECT * FROM `table_name` WHERE `COLUMN` IN (?a)', array(10, '20', '30', 40.3));\n```\n```sql\nSELECT * FROM `table_name` WHERE `COLUMN` IN (10, 20, 30, 40);\n```\n\n**?j — bind value as string array.**\n\n```php\nselect('SELECT * FROM `table_name` WHERE `COLUMN` IN (?j)', array('p', 'd', 'o'));\n```\n```sql\nSELECT * FROM `table_name` WHERE `COLUMN` IN ('p', 'd', 'o');\n```\n\n**?h — bind value as string array with key as column name and value as column value.**\n\n```php\nselect('UPDATE `table_name` SET ?h', array('COLUMN1' =\u003e 'One', 'COLUMN2' =\u003e 'Two', 'COLUMN3' =\u003e 'Three'));\n```\n```sql\nUPDATE `table_name` SET `COLUMN1` = 'One', `COLUMN2` = 'Two', `COLUMN3` = 'Three';\n```\n\n**?w — bind value as string array with key as column name and value as column value with delimiter AND.**\n\n```php\nselect('SELECT * FROM `table_name` WHERE ?w', array('COLUMN1' =\u003e 'Three', 'COLUMN2' =\u003e 'Two', 'COLUMN3' =\u003e 'One'));\n```\n```sql\nSELECT * FROM `table_name` WHERE `COLUMN1` = 'Three' AND `COLUMN2` = 'Two' AND `COLUMN3` = 'One';\n```\n\n**Named placeholders**\n\n```php\nselect('SELECT * FROM `table_name` WHERE `COLUMN` = :val OR `COLUMN` :val2', array(':val' =\u003e 'VALUE', ':val2' =\u003e 'VALUE'));\n```\n```sql\nSELECT * FROM `table_name` WHERE `COLUMN` = 'VALUE' OR `COLUMN2` = 'VALUE';\n```\n\n## Support\nIf you like this script please support by staring or forking the repository.\n\n## How to contribute\n\nAlways welcome\n\n* Create an [issue](https://github.com/catsAND/PDO-Database-Wrapper/issues) on GitHub, if you have found a bug or for enhancement.\n* Create a [Pull requests](https://github.com/catsAND/PDO-Database-Wrapper/pulls) for open bug/feature issues.\n\n## Thanks to\n* [Indieteq](https://github.com/indieteq)\n* [Tino Ehrich](https://github.com/fightbulc)\n\n## License\nThis project is licensed under the MIT License - see the [LICENSE.md](https://github.com/catsAND/PDO-Database-Wrapper/blob/master/LICENSE) file for details\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcatsand%2Fpdo-database-wrapper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcatsand%2Fpdo-database-wrapper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcatsand%2Fpdo-database-wrapper/lists"}