diff --git a/reference/sockets/constants.xml b/reference/sockets/constants.xml index e1e4b9ada057..c909972e9bea 100644 --- a/reference/sockets/constants.xml +++ b/reference/sockets/constants.xml @@ -3185,6 +3185,198 @@ + + + SHUT_RD + (int) + + + + Disables further receive operations on the socket. + Used with socket_shutdown. + Available as of PHP 8.5.0. + + + + + + SHUT_WR + (int) + + + + Disables further send operations on the socket. + Used with socket_shutdown. + Available as of PHP 8.5.0. + + + + + + SHUT_RDWR + (int) + + + + Disables further send and receive operations on the socket. + Used with socket_shutdown. + Available as of PHP 8.5.0. + + + + + + UDP_SEGMENT + (int) + + + + Sets the maximum size of UDP Generic Segmentation Offload (GSO) segments, + allowing multiple datagrams to be sent in a single system call. + Available on Linux only. + Available as of PHP 8.5.0. + + + + + + SO_BUSY_POLL + (int) + + + + Sets the approximate time in microseconds to busy poll on a blocking + receive when there is no data. This reduces latency at the cost of CPU. + Available on Linux only. + Available as of PHP 8.5.0. + + + + + + IP_BINDANY + (int) + + + + Allows binding a socket to any address, even if it is not local. + Available on FreeBSD, NetBSD, and OpenBSD only. + Available as of PHP 8.5.0. + + + + + + TCP_FUNCTION_BLK + (int) + + + + Selects the TCP stack (function block) used by the socket. With + socket_set_option the value is the name of the stack + as a string; socket_get_option returns an + array with the function_set_name and + pcbcnt keys. + Available on FreeBSD only. + Available as of PHP 8.5.0. + + + + + + TCP_FUNCTION_ALIAS + (int) + + + + Retrieves the alias of the TCP stack used by the socket, as an array with + the function_set_name and pcbcnt keys. + Available on FreeBSD only. + Available as of PHP 8.5.0. + + + + + + TCP_REUSPORT_LB_NUMA + (int) + + + + Controls NUMA domain affinity for load-balanced port reuse. + Available on FreeBSD only. + Available as of PHP 8.5.0. + + + + + + TCP_REUSPORT_LB_NUMA_NODOM + (int) + + + + Constant value for TCP_REUSPORT_LB_NUMA indicating + no NUMA domain affinity. + Available on FreeBSD only. + Available as of PHP 8.5.0. + + + + + + TCP_REUSPORT_LB_NUMA_CURDOM + (int) + + + + Constant value for TCP_REUSPORT_LB_NUMA indicating + affinity for the current NUMA domain. + Available on FreeBSD only. + Available as of PHP 8.5.0. + + + + + + TCP_BBR_ALGORITHM + (int) + + + + Socket option related to the BBR (Bottleneck Bandwidth and Round-trip + propagation time) congestion control algorithm. + Available on FreeBSD only. + Available as of PHP 8.5.0. + + + + + + IPPROTO_ICMP + (int) + + + + Internet Control Message Protocol (ICMP) protocol number, + used when creating raw sockets. + Available as of PHP 8.5.0. + + + + + + IPPROTO_ICMPV6 + (int) + + + + Internet Control Message Protocol version 6 (ICMPv6) protocol number, + used when creating raw IPv6 sockets. + Available as of PHP 8.5.0. + + + diff --git a/reference/sqlite3/sqlite3stmt.xml b/reference/sqlite3/sqlite3stmt.xml index 59601efa0f87..e9b5003488f5 100644 --- a/reference/sqlite3/sqlite3stmt.xml +++ b/reference/sqlite3/sqlite3stmt.xml @@ -9,9 +9,12 @@
&reftitle.intro; - + A class that handles prepared statements for the SQLite 3 extension. - + Instances are obtained from SQLite3::prepare. + Calling SQLite3Stmt::execute runs the query and + returns a SQLite3Result for result sets. +
@@ -24,6 +27,29 @@ SQLite3Stmt + &Constants; + + public + const + int + SQLite3Stmt::EXPLAIN_MODE_PREPARED + 0 + + + public + const + int + SQLite3Stmt::EXPLAIN_MODE_EXPLAIN + 1 + + + public + const + int + SQLite3Stmt::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN + 2 + + &Methods; @@ -32,6 +58,47 @@ + +
+ &reftitle.constants; + + + + SQLite3Stmt::EXPLAIN_MODE_PREPARED + + + The statement operates in normal prepared statement mode (no EXPLAIN). + Available as of PHP 8.5.0, when compiled against libsqlite >= 3.43.0. + + + + + + SQLite3Stmt::EXPLAIN_MODE_EXPLAIN + + + The statement operates as if prefixed with EXPLAIN, + returning opcode information from the virtual machine. + Available as of PHP 8.5.0, when compiled against libsqlite >= 3.43.0. + + + + + + SQLite3Stmt::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN + + + The statement operates as if prefixed with EXPLAIN QUERY PLAN, + returning high-level query plan information. + Available as of PHP 8.5.0, when compiled against libsqlite >= 3.43.0. + + + + + +
+ + &reference.sqlite3.entities.sqlite3stmt; diff --git a/reference/sqlite3/sqlite3stmt/busy.xml b/reference/sqlite3/sqlite3stmt/busy.xml new file mode 100644 index 000000000000..56a564ec07d5 --- /dev/null +++ b/reference/sqlite3/sqlite3stmt/busy.xml @@ -0,0 +1,86 @@ + + + + + SQLite3Stmt::busy + Returns whether the statement has been fetched but not yet completed + + + + &reftitle.description; + + public boolSQLite3Stmt::busy + + + + Returns whether the statement is busy, i.e. it has been started with + SQLite3Stmt::execute and has rows remaining to be fetched, + but has not yet been completed or reset. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns &true; if the statement has been executed and still has rows to fetch, + &false; otherwise. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.5.0 + + This method was added. + + + + + + + + + &reftitle.seealso; + + SQLite3Stmt::execute + SQLite3Stmt::reset + SQLite3Stmt::close + + + + + diff --git a/reference/sqlite3/sqlite3stmt/explain.xml b/reference/sqlite3/sqlite3stmt/explain.xml new file mode 100644 index 000000000000..81ce6520e52a --- /dev/null +++ b/reference/sqlite3/sqlite3stmt/explain.xml @@ -0,0 +1,64 @@ + + + + + SQLite3Stmt::explain + Returns the explain mode of the statement + + + + &reftitle.description; + + public intSQLite3Stmt::explain + + + + Returns the explain mode currently set on the statement with + SQLite3Stmt::setExplain. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns one of SQLite3Stmt::EXPLAIN_MODE_PREPARED, + SQLite3Stmt::EXPLAIN_MODE_EXPLAIN, or + SQLite3Stmt::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN. + + + + + &reftitle.seealso; + + SQLite3Stmt::setExplain + SQLite3Stmt::execute + SQLite3Stmt::reset + + + + + diff --git a/reference/sqlite3/sqlite3stmt/setexplain.xml b/reference/sqlite3/sqlite3stmt/setexplain.xml new file mode 100644 index 000000000000..a4c02d37f7e8 --- /dev/null +++ b/reference/sqlite3/sqlite3stmt/setexplain.xml @@ -0,0 +1,81 @@ + + + + + SQLite3Stmt::setExplain + Changes the explain mode of the statement + + + + &reftitle.description; + + public boolSQLite3Stmt::setExplain + intmode + + + Changes the explain mode of the statement, so that it behaves as if its SQL + was prefixed with EXPLAIN or + EXPLAIN QUERY PLAN, or as an ordinary statement again. + + + + + &reftitle.parameters; + + + mode + + + One of SQLite3Stmt::EXPLAIN_MODE_PREPARED, + SQLite3Stmt::EXPLAIN_MODE_EXPLAIN, or + SQLite3Stmt::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN. + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.errors; + + A ValueError is thrown if mode + is not one of the SQLite3Stmt::EXPLAIN_MODE_* constants. + + + + + &reftitle.seealso; + + SQLite3Stmt::explain + SQLite3Stmt::execute + + + + + diff --git a/reference/sqlite3/versions.xml b/reference/sqlite3/versions.xml index 506787119e3b..33bfc042c049 100644 --- a/reference/sqlite3/versions.xml +++ b/reference/sqlite3/versions.xml @@ -32,6 +32,9 @@ + + + @@ -41,6 +44,9 @@ + + +