clones/php-src
1
0
Fork 0
mirror of https://github.com/php/php-src.git synced 2024-09-23 19:07:26 +00:00
Code Issues Packages Projects Releases Wiki Activity
9ec519e094
php-src/ext/pdo/php_pdo_int.h

74 lines
3.0 KiB
C
Raw Normal View History

Hello PDO. Still more to come. Give it a couple of days before starting to write drivers for the other databases; a few things might change, so I'd like to coordinate that, but in a couple of days.
2004-05-17 15:41:51 +00:00
/*
+----------------------------------------------------------------------+
s/PHP 5/PHP 7/
2014-09-19 16:33:14 +00:00
| PHP Version 7 |
Hello PDO. Still more to come. Give it a couple of days before starting to write drivers for the other databases; a few things might change, so I'd like to coordinate that, but in a couple of days.
2004-05-17 15:41:51 +00:00
+----------------------------------------------------------------------+
year++
2018-01-02 04:55:14 +00:00
| Copyright (c) 1997-2018 The PHP Group |
Hello PDO. Still more to come. Give it a couple of days before starting to write drivers for the other databases; a few things might change, so I'd like to coordinate that, but in a couple of days.
2004-05-17 15:41:51 +00:00
+----------------------------------------------------------------------+
bump year and license version
2006-01-01 12:51:34 +00:00
| This source file is subject to version 3.01 of the PHP license, |
Hello PDO. Still more to come. Give it a couple of days before starting to write drivers for the other databases; a few things might change, so I'd like to coordinate that, but in a couple of days.
2004-05-17 15:41:51 +00:00
| that is bundled with this package in the file LICENSE, and is |
| available through the world-wide-web at the following url: |
bump year and license version
2006-01-01 12:51:34 +00:00
| http://www.php.net/license/3_01.txt |
Hello PDO. Still more to come. Give it a couple of days before starting to write drivers for the other databases; a few things might change, so I'd like to coordinate that, but in a couple of days.
2004-05-17 15:41:51 +00:00
| If you did not receive a copy of the PHP license and are unable to |
| obtain it through the world-wide-web, please send a note to |
| license@php.net so we can mail you a copy immediately. |
+----------------------------------------------------------------------+
| Author: Wez Furlong <wez@php.net> |
| Marcus Boerger <helly@php.net> |
| Sterling Hughes <sterling@php.net> |
+----------------------------------------------------------------------+
*/
/* $Id$ */
/* Stuff private to the PDO extension and not for consumption by PDO drivers
* */
fix build (declare extern HashTable pdo_driver_hash)
2005-09-18 18:05:59 +00:00
Allow PDO drivers custom methods to trigger errors/exceptions Moved a few definitions from php_pdo_int.h to a new php_pdo_error.h header file that can be included if drivers need PDO's own error handling to be triggered within custom methods (e.g. PDO::pgsqlLOBOpen).
2013-06-04 14:49:16 +00:00
#include "php_pdo_error.h"
fix build (declare extern HashTable pdo_driver_hash)
2005-09-18 18:05:59 +00:00
extern HashTable pdo_driver_hash;
Hello PDO. Still more to come. Give it a couple of days before starting to write drivers for the other databases; a few things might change, so I'd like to coordinate that, but in a couple of days.
2004-05-17 15:41:51 +00:00
extern zend_class_entry *pdo_exception_ce;
first shot remove TSRMLS_* things
2014-12-13 22:06:14 +00:00
PDO_API zend_class_entry *php_pdo_get_exception_base(int root);
Implement persistent connections $dbh->exec --> $dbh->query
2004-09-23 20:07:02 +00:00
int php_pdo_list_entry(void);
- Simplify code (only implement handlers that are necessary) - Fix handling of read only property 'queryString' - Fix overloading - Move class init code to their defining .c files for simplification - Mark class PDORow as final until there's a need to inherit this and someone implements the handlers correct then.
2005-03-21 00:29:06 +00:00
first shot remove TSRMLS_* things
2014-12-13 22:06:14 +00:00
void pdo_dbh_init(void);
void pdo_stmt_init(void);
Hello PDO. Still more to come. Give it a couple of days before starting to write drivers for the other databases; a few things might change, so I'd like to coordinate that, but in a couple of days.
2004-05-17 15:41:51 +00:00
first shot remove TSRMLS_* things
2014-12-13 22:06:14 +00:00
extern zend_object *pdo_dbh_new(zend_class_entry *ce);
Improved memory usage by movig constants to read only memory. (Dmitry, Pierre)
2007-09-27 18:00:48 +00:00
extern const zend_function_entry pdo_dbh_functions[];
Hello PDO. Still more to come. Give it a couple of days before starting to write drivers for the other databases; a few things might change, so I'd like to coordinate that, but in a couple of days.
2004-05-17 15:41:51 +00:00
extern zend_class_entry *pdo_dbh_ce;
Implement persistent connections $dbh->exec --> $dbh->query
2004-09-23 20:07:02 +00:00
extern ZEND_RSRC_DTOR_FUNC(php_pdo_pdbh_dtor);
Hello PDO. Still more to come. Give it a couple of days before starting to write drivers for the other databases; a few things might change, so I'd like to coordinate that, but in a couple of days.
2004-05-17 15:41:51 +00:00
first shot remove TSRMLS_* things
2014-12-13 22:06:14 +00:00
extern zend_object *pdo_dbstmt_new(zend_class_entry *ce);
Improved memory usage by movig constants to read only memory. (Dmitry, Pierre)
2007-09-27 18:00:48 +00:00
extern const zend_function_entry pdo_dbstmt_functions[];
Hello PDO. Still more to come. Give it a couple of days before starting to write drivers for the other databases; a few things might change, so I'd like to coordinate that, but in a couple of days.
2004-05-17 15:41:51 +00:00
extern zend_class_entry *pdo_dbstmt_ce;
first shot remove TSRMLS_* things
2014-12-13 22:06:14 +00:00
void pdo_dbstmt_free_storage(zend_object *std);
zend_object_iterator *pdo_stmt_iter_get(zend_class_entry *ce, zval *object, int by_ref);
Hello PDO. Still more to come. Give it a couple of days before starting to write drivers for the other databases; a few things might change, so I'd like to coordinate that, but in a couple of days.
2004-05-17 15:41:51 +00:00
extern zend_object_handlers pdo_dbstmt_object_handlers;
first shot remove TSRMLS_* things
2014-12-13 22:06:14 +00:00
int pdo_stmt_describe_columns(pdo_stmt_t *stmt);
Synopsis: PDOStatement::setFetchMode() reset default fetch() mode for a statement to PDO_FETCH_BOTH PDOStatement::setFetchMode(PDO_FETCH_NUM) PDOStatement::setFetchMode(PDO_FETCH_ASSOC) PDOStatement::setFetchMode(PDO_FETCH_BOTH) PDOStatement::setFetchMode(PDO_FETCH_OBJ) set default fetch() mode for a statement. PDOStatement::setFetchMode(PDO_FETCH_COLUMN, int colno) set default fetch() mode to retrieve colno-th column on each fetch() call. PDOStatement::setFetchMode(PDO_FETCH_CLASS, string classname [, array ctor args]) set default fetch() mode to create an instance of classname, calling it's ctor, passing the optional ctor args. The names of the columns in the result set will be used as property names on the object instance. PPP rules apply. [NOTE: calling ctor is not yet implemented] [TODO: this might crash PHP for persistent PDO handles] PDOStatement::setFetchMode(PDO_FETCH_INTO, object obj) Similar to PDO_FETCH_CLASS, except that each iteration will update the supplied object properties. [TODO: this might crash PHP for persistent PDO handles] The default fetch() mode is used when no parameters are passed to PDOStatement::fetch(). When using a statement in an iterator context, PDOStatement::fetch() is called implicitly on each iteration. object PDO::queryAndIterate(string sql, <PDOStatement::setFetchMode args>) This is semantically equivalent to: $stmt = $pdo->prepare($sql); $stmt->execute(); $stmt->setFetchMode($args); return $stmt; Example/Intended usage: /* fetch an array with numeric and string keys */ foreach ($pdo->queryAndIterate("select NAME, VALUE from test") as $row) { debug_zval_dump($row); } /* fetch the value of column 1 into $row on each iteration */ foreach ($pdo->queryAndIterate("select NAME, VALUE from test", PDO_FETCH_COLUMN, 1) as $row) { debug_zval_dump($row); // string(3) "foo" } /* create a new instance of class Foo on each iteration */ foreach ($pdo->queryAndIterate("select NAME, VALUE from test", PDO_FETCH_CLASS, 'Foo') as $row) { debug_zval_dump($row); /* Object(Foo)#4 (2) refcount(2){ ["NAME"]=> string(12) "foo220051429" refcount(2) ["VALUE"]=> string(12) "bar789825748" refcount(2) } */ } etc.
2004-10-27 10:26:27 +00:00
int pdo_stmt_setup_fetch_mode(INTERNAL_FUNCTION_PARAMETERS, pdo_stmt_t *stmt, int skip_first_arg);
Hello PDO. Still more to come. Give it a couple of days before starting to write drivers for the other databases; a few things might change, so I'd like to coordinate that, but in a couple of days.
2004-05-17 15:41:51 +00:00
first shot remove TSRMLS_* things
2014-12-13 22:06:14 +00:00
extern zend_object *pdo_row_new(zend_class_entry *ce);
Improved memory usage by movig constants to read only memory. (Dmitry, Pierre)
2007-09-27 18:00:48 +00:00
extern const zend_function_entry pdo_row_functions[];
Version 1 of PDO_FETCH_LAZY
2004-05-21 13:26:58 +00:00
extern zend_class_entry *pdo_row_ce;
first shot remove TSRMLS_* things
2014-12-13 22:06:14 +00:00
void pdo_row_free_storage(zend_object *std);
Version 1 of PDO_FETCH_LAZY
2004-05-21 13:26:58 +00:00
extern zend_object_handlers pdo_row_object_handlers;
first shot remove TSRMLS_* things
2014-12-13 22:06:14 +00:00
zend_object_iterator *php_pdo_dbstmt_iter_get(zend_class_entry *ce, zval *object);
Version 1 of PDO_FETCH_LAZY
2004-05-21 13:26:58 +00:00
Hello PDO. Still more to come. Give it a couple of days before starting to write drivers for the other databases; a few things might change, so I'd like to coordinate that, but in a couple of days.
2004-05-17 15:41:51 +00:00
extern pdo_driver_t *pdo_find_driver(const char *name, int namelen);
implement SQLSTATE style error codes. Allow drivers to add methods to dbh and stmt objects (note that we can't use a class, because the use only sees the PDO class). Clarify the api slightly: PDO::exec() is used for one-shot queries that don't return rows PDO::query() is a convenience function for returning a rowset without having to go through the steps of preparing and executing.
2005-01-07 05:23:10 +00:00
int pdo_sqlstate_init_error_table(void);
void pdo_sqlstate_fini_error_table(void);
const char *pdo_sqlstate_state_to_description(char *state);
first shot remove TSRMLS_* things
2014-12-13 22:06:14 +00:00
int pdo_hash_methods(pdo_dbh_object_t *dbh, int kind);
implement SQLSTATE style error codes. Allow drivers to add methods to dbh and stmt objects (note that we can't use a class, because the use only sees the PDO class). Clarify the api slightly: PDO::exec() is used for one-shot queries that don't return rows PDO::query() is a convenience function for returning a rowset without having to go through the steps of preparing and executing.
2005-01-07 05:23:10 +00:00
First cut at a "unified" error handling API. The main thing that is missing currently is a switch in the dbh to indicate what to do with the errors.
2004-05-20 00:05:22 +00:00
Hello PDO. Still more to come. Give it a couple of days before starting to write drivers for the other databases; a few things might change, so I'd like to coordinate that, but in a couple of days.
2004-05-17 15:41:51 +00:00
/*
* Local variables:
* tab-width: 4
* c-basic-offset: 4
* End:
* vim600: noet sw=4 ts=4 fdm=marker
* vim<600: noet sw=4 ts=4
*/
Reference in New Issue Copy Permalink