6987097851

Committed 25 Nov 2023 04:49AM UTC coverage: 49.206% (-0.1%) from 49.302%

Build # 6987097851

Build Type

push

github

Committed by

web-flow

Commit Message

Merge pull request #20878 from Yoast/JRF/ghactions-minor-tweak

GH Actions: update a few links in inline comments

Run Details

15305 of 31104 relevant lines covered (49.21%)

4.03 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

64.13

/admin/class-database-proxy.php

<?php
/**
 * WPSEO plugin file.
 *
 * @package WPSEO\Admin
 */

/**
 * Represents the proxy for communicating with the database.
 */
class WPSEO_Database_Proxy {

        /**
         * Holds the table name.
         *
         * @var string
         */
        protected $table_name;

        /**
         * Determines whether to suppress errors or not.
         *
         * @var bool
         */
        protected $suppress_errors = true;

        /**
         * Determines if this table is multisite.
         *
         * @var bool
         */
        protected $is_multisite_table = false;

        /**
         * Holds the last suppressed state.
         *
         * @var bool
         */
        protected $last_suppressed_state;

        /**
         * Holds the WordPress database object.
         *
         * @var wpdb
         */
        protected $database;

        /**
         * Sets the class attributes and registers the table.
         *
         * @param wpdb   $database           The database object.
         * @param string $table_name         The table name that is represented.
         * @param bool   $suppress_errors    Should the errors be suppressed.
         * @param bool   $is_multisite_table Should the table be global in multisite.
         */
        public function __construct( $database, $table_name, $suppress_errors = true, $is_multisite_table = false ) {
                $this->table_name         = $table_name;
                $this->suppress_errors    = (bool) $suppress_errors;
                $this->is_multisite_table = (bool) $is_multisite_table;
                $this->database           = $database;

                // If the table prefix was provided, strip it as it's handled automatically.
                $table_prefix = $this->get_table_prefix();
                if ( ! empty( $table_prefix ) && strpos( $this->table_name, $table_prefix ) === 0 ) {
                        $this->table_prefix = substr( $this->table_name, strlen( $table_prefix ) );
                }

                if ( ! $this->is_table_registered() ) {
                        $this->register_table();
                }
        }

        /**
         * Inserts data into the database.
         *
         * @param array             $data   Data to insert.
         * @param array|string|null $format Formats for the data.
         *
         * @return false|int Total amount of inserted rows or false on error.
         */
        public function insert( array $data, $format = null ) {
                $this->pre_execution();

                $result = $this->database->insert( $this->get_table_name(), $data, $format );

                $this->post_execution();

                return $result;
        }

        /**
         * Updates data in the database.
         *
         * @param array             $data         Data to update on the table.
         * @param array             $where        Where condition as key => value array.
         * @param array|string|null $format       Optional. Data prepare format.
         * @param array|string|null $where_format Optional. Where prepare format.
         *
         * @return false|int False when the update request is invalid, int on number of rows changed.
         */
        public function update( array $data, array $where, $format = null, $where_format = null ) {
                $this->pre_execution();

                $result = $this->database->update( $this->get_table_name(), $data, $where, $format, $where_format );

                $this->post_execution();

                return $result;
        }

        /**
         * Upserts data in the database.
         *
         * Performs an insert into and if key is duplicate it will update the existing record.
         *
         * @param array             $data         Data to update on the table.
         * @param array|null        $where        Unused. Where condition as key => value array.
         * @param array|string|null $format       Optional. Data prepare format.
         * @param array|string|null $where_format Optional. Where prepare format.
         *
         * @return false|int False when the upsert request is invalid, int on number of rows changed.
         */
        public function upsert( array $data, array $where = null, $format = null, $where_format = null ) {
                if ( $where_format !== null ) {
                        _deprecated_argument( __METHOD__, '7.7.0', 'The where_format argument is deprecated' );
                }

                $this->pre_execution();

                $update  = [];
                $keys    = [];
                $columns = array_keys( $data );
                foreach ( $columns as $column ) {
                        $keys[]   = '`' . $column . '`';
                        $update[] = sprintf( '`%1$s` = VALUES(`%1$s`)', $column );
                }

                $query = sprintf(
                        'INSERT INTO `%1$s` (%2$s) VALUES ( %3$s ) ON DUPLICATE KEY UPDATE %4$s',
                        $this->get_table_name(),
                        implode( ', ', $keys ),
                        implode( ', ', array_fill( 0, count( $data ), '%s' ) ),
                        implode( ', ', $update )
                );

                $result = $this->database->query(
                        $this->database->prepare(
                                $query,
                                array_values( $data )
                        )
                );

                $this->post_execution();

                return $result;
        }

        /**
         * Deletes a record from the database.
         *
         * @param array             $where  Where clauses for the query.
         * @param array|string|null $format Formats for the data.
         *
         * @return false|int
         */
        public function delete( array $where, $format = null ) {
                $this->pre_execution();

                $result = $this->database->delete( $this->get_table_name(), $where, $format );

                $this->post_execution();

                return $result;
        }

        /**
         * Executes the given query and returns the results.
         *
         * @param string $query The query to execute.
         *
         * @return array|object|null The resultset
         */
        public function get_results( $query ) {
                $this->pre_execution();

                $results = $this->database->get_results( $query );

                $this->post_execution();

                return $results;
        }

        /**
         * Creates a table to the database.
         *
         * @param array $columns The columns to create.
         * @param array $indexes The indexes to use.
         *
         * @return bool True when creation is successful.
         */
        public function create_table( array $columns, array $indexes = [] ) {
                $create_table = sprintf(
                        'CREATE TABLE IF NOT EXISTS %1$s ( %2$s ) %3$s',
                        $this->get_table_name(),
                        implode( ',', array_merge( $columns, $indexes ) ),
                        $this->database->get_charset_collate()
                );

                $this->pre_execution();

                $is_created = (bool) $this->database->query( $create_table );

                $this->post_execution();

                return $is_created;
        }

        /**
         * Checks if there is an error.
         *
         * @return bool Returns true when there is an error.
         */
        public function has_error() {
                return ( $this->database->last_error !== '' );
        }

        /**
         * Executed before a query will be ran.
         */
        protected function pre_execution() {
                if ( $this->suppress_errors ) {
                        $this->last_suppressed_state = $this->database->suppress_errors();
                }
        }

        /**
         * Executed after a query has been ran.
         */
        protected function post_execution() {
                if ( $this->suppress_errors ) {
                        $this->database->suppress_errors( $this->last_suppressed_state );
                }
        }

        /**
         * Returns the full table name.
         *
         * @return string Full table name including prefix.
         */
        public function get_table_name() {
                return $this->get_table_prefix() . $this->table_name;
        }

        /**
         * Returns the prefix to use for the table.
         *
         * @return string The table prefix depending on the database context.
         */
        protected function get_table_prefix() {
                if ( $this->is_multisite_table ) {
                        return $this->database->base_prefix;
                }

                return $this->database->get_blog_prefix();
        }

        /**
         * Registers the table with WordPress.
         *
         * @return void
         */
        protected function register_table() {
                $table_name      = $this->table_name;
                $full_table_name = $this->get_table_name();

                $this->database->$table_name = $full_table_name;

                if ( $this->is_multisite_table ) {
                        $this->database->ms_global_tables[] = $table_name;
                        return;
                }

                $this->database->tables[] = $table_name;
        }

        /**
         * Checks if the table has been registered with WordPress.
         *
         * @return bool True if the table is registered, false otherwise.
         */
        protected function is_table_registered() {
                if ( $this->is_multisite_table ) {
                        return in_array( $this->table_name, $this->database->ms_global_tables, true );
                }

                return in_array( $this->table_name, $this->database->tables, true );
        }
}

1	<?php
2	/**
3	* WPSEO plugin file.
4	*
5	* @package WPSEO\Admin
6	*/
7
8	/**
9	* Represents the proxy for communicating with the database.
10	*/
11	class WPSEO_Database_Proxy {
12
13	/**
14	* Holds the table name.
15	*
16	* @var string
17	*/
18	protected $table_name;
19
20	/**
21	* Determines whether to suppress errors or not.
22	*
23	* @var bool
24	*/
25	protected $suppress_errors = true;
26
27	/**
28	* Determines if this table is multisite.
29	*
30	* @var bool
31	*/
32	protected $is_multisite_table = false;
33
34	/**
35	* Holds the last suppressed state.
36	*
37	* @var bool
38	*/
39	protected $last_suppressed_state;
40
41	/**
42	* Holds the WordPress database object.
43	*
44	* @var wpdb
45	*/
46	protected $database;
47
48	/**
49	* Sets the class attributes and registers the table.
50	*
51	* @param wpdb $database The database object.
52	* @param string $table_name The table name that is represented.
53	* @param bool $suppress_errors Should the errors be suppressed.
54	* @param bool $is_multisite_table Should the table be global in multisite.
55	*/
56	public function __construct( $database, $table_name, $suppress_errors = true, $is_multisite_table = false ) {	×
57	$this->table_name = $table_name;	×
58	$this->suppress_errors = (bool) $suppress_errors;	×
59	$this->is_multisite_table = (bool) $is_multisite_table;	×
60	$this->database = $database;	×
61
62	// If the table prefix was provided, strip it as it's handled automatically.
63	$table_prefix = $this->get_table_prefix();	×
64	if ( ! empty( $table_prefix ) && strpos( $this->table_name, $table_prefix ) === 0 ) {	×
65	$this->table_prefix = substr( $this->table_name, strlen( $table_prefix ) );	×
66	}
67
68	if ( ! $this->is_table_registered() ) {	×
69	$this->register_table();	×
70	}
71	}
72
73	/**
74	* Inserts data into the database.
75	*
76	* @param array $data Data to insert.
77	* @param array\|string\|null $format Formats for the data.
78	*
79	* @return false\|int Total amount of inserted rows or false on error.
80	*/
81	public function insert( array $data, $format = null ) {	12✔
82	$this->pre_execution();	12✔
83
84	$result = $this->database->insert( $this->get_table_name(), $data, $format );	12✔
85
86	$this->post_execution();	12✔
87
88	return $result;	12✔
89	}
90
91	/**
92	* Updates data in the database.
93	*
94	* @param array $data Data to update on the table.
95	* @param array $where Where condition as key => value array.
96	* @param array\|string\|null $format Optional. Data prepare format.
97	* @param array\|string\|null $where_format Optional. Where prepare format.
98	*
99	* @return false\|int False when the update request is invalid, int on number of rows changed.
100	*/
101	public function update( array $data, array $where, $format = null, $where_format = null ) {	12✔
102	$this->pre_execution();	12✔
103
104	$result = $this->database->update( $this->get_table_name(), $data, $where, $format, $where_format );	12✔
105
106	$this->post_execution();	12✔
107
108	return $result;	12✔
109	}
110
111	/**
112	* Upserts data in the database.
113	*
114	* Performs an insert into and if key is duplicate it will update the existing record.
115	*
116	* @param array $data Data to update on the table.
117	* @param array\|null $where Unused. Where condition as key => value array.
118	* @param array\|string\|null $format Optional. Data prepare format.
119	* @param array\|string\|null $where_format Optional. Where prepare format.
120	*
121	* @return false\|int False when the upsert request is invalid, int on number of rows changed.
122	*/
123	public function upsert( array $data, array $where = null, $format = null, $where_format = null ) {	8✔
124	if ( $where_format !== null ) {	8✔
125	_deprecated_argument( __METHOD__, '7.7.0', 'The where_format argument is deprecated' );	×
126	}
127
128	$this->pre_execution();	8✔
129
130	$update = [];	8✔
131	$keys = [];	8✔
132	$columns = array_keys( $data );	8✔
133	foreach ( $columns as $column ) {	8✔
134	$keys[] = '`' . $column . '`';	8✔
135	$update[] = sprintf( '`%1$s` = VALUES(`%1$s`)', $column );	8✔
136	}
137
138	$query = sprintf(	8✔
139	'INSERT INTO `%1$s` (%2$s) VALUES ( %3$s ) ON DUPLICATE KEY UPDATE %4$s',	8✔
140	$this->get_table_name(),	8✔
141	implode( ', ', $keys ),	8✔
142	implode( ', ', array_fill( 0, count( $data ), '%s' ) ),	8✔
143	implode( ', ', $update )	8✔
144	);	4✔
145
146	$result = $this->database->query(	8✔
147	$this->database->prepare(	8✔
148	$query,	8✔
149	array_values( $data )	8✔
150	)	4✔
151	);	4✔
152
153	$this->post_execution();	8✔
154
155	return $result;	8✔
156	}
157
158	/**
159	* Deletes a record from the database.
160	*
161	* @param array $where Where clauses for the query.
162	* @param array\|string\|null $format Formats for the data.
163	*
164	* @return false\|int
165	*/
166	public function delete( array $where, $format = null ) {	12✔
167	$this->pre_execution();	12✔
168
169	$result = $this->database->delete( $this->get_table_name(), $where, $format );	12✔
170
171	$this->post_execution();	12✔
172
173	return $result;	12✔
174	}
175
176	/**
177	* Executes the given query and returns the results.
178	*
179	* @param string $query The query to execute.
180	*
181	* @return array\|object\|null The resultset
182	*/
183	public function get_results( $query ) {	4✔
184	$this->pre_execution();	4✔
185
186	$results = $this->database->get_results( $query );	4✔
187
188	$this->post_execution();	4✔
189
190	return $results;	4✔
191	}
192
193	/**
194	* Creates a table to the database.
195	*
196	* @param array $columns The columns to create.
197	* @param array $indexes The indexes to use.
198	*
199	* @return bool True when creation is successful.
200	*/
201	public function create_table( array $columns, array $indexes = [] ) {	4✔
202	$create_table = sprintf(	4✔
203	'CREATE TABLE IF NOT EXISTS %1$s ( %2$s ) %3$s',	4✔
204	$this->get_table_name(),	4✔
205	implode( ',', array_merge( $columns, $indexes ) ),	4✔
206	$this->database->get_charset_collate()	4✔
207	);	2✔
208
209	$this->pre_execution();	4✔
210
211	$is_created = (bool) $this->database->query( $create_table );	4✔
212
213	$this->post_execution();	4✔
214
215	return $is_created;	4✔
216	}
217
218	/**
219	* Checks if there is an error.
220	*
221	* @return bool Returns true when there is an error.
222	*/
223	public function has_error() {	4✔
224	return ( $this->database->last_error !== '' );	4✔
225	}
226
227	/**
228	* Executed before a query will be ran.
229	*/
230	protected function pre_execution() {	×
231	if ( $this->suppress_errors ) {	×
232	$this->last_suppressed_state = $this->database->suppress_errors();	×
233	}
234	}
235
236	/**
237	* Executed after a query has been ran.
238	*/
239	protected function post_execution() {	×
240	if ( $this->suppress_errors ) {	×
241	$this->database->suppress_errors( $this->last_suppressed_state );	×
242	}
243	}
244
245	/**
246	* Returns the full table name.
247	*
248	* @return string Full table name including prefix.
249	*/
250	public function get_table_name() {	8✔
251	return $this->get_table_prefix() . $this->table_name;	8✔
252	}
253
254	/**
255	* Returns the prefix to use for the table.
256	*
257	* @return string The table prefix depending on the database context.
258	*/
259	protected function get_table_prefix() {	×
260	if ( $this->is_multisite_table ) {	×
261	return $this->database->base_prefix;	×
262	}
263
264	return $this->database->get_blog_prefix();	×
265	}
266
267	/**
268	* Registers the table with WordPress.
269	*
270	* @return void
271	*/
272	protected function register_table() {	×
273	$table_name = $this->table_name;	×
274	$full_table_name = $this->get_table_name();	×
275
276	$this->database->$table_name = $full_table_name;	×
277
278	if ( $this->is_multisite_table ) {	×
279	$this->database->ms_global_tables[] = $table_name;	×
280	return;	×
281	}
282
283	$this->database->tables[] = $table_name;	×
284	}
285
286	/**
287	* Checks if the table has been registered with WordPress.
288	*
289	* @return bool True if the table is registered, false otherwise.
290	*/
291	protected function is_table_registered() {	×
292	if ( $this->is_multisite_table ) {	×
293	return in_array( $this->table_name, $this->database->ms_global_tables, true );	×
294	}
295
296	return in_array( $this->table_name, $this->database->tables, true );	×
297	}
298	}

Yoast / wordpress-seo / 6987097851

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous