for more * information. * * * * This option is supported in PECL YAZ 1.0.5 or later. * * * * * * * maximumRecordSize * * * An integer that specifies the maximum byte size of a single record * to be returned by a target during retrieval. This * entity is referred to as Exceptional-record-size in the * Z39.50 standard. * * * * This option is supported in PECL YAZ 1.0.5 or later. * * * * * * * * Username for authentication. * * Group for authentication. * * Password for authentication. * * Cookie for session (YAZ proxy). * * Proxy for connection (YAZ proxy). * * A boolean. If TRUE the connection is persistent; If FALSE the * connection is not persistent. By default connections are persistent. * * If you open a persistent connection, you won't be able to close * it later with yaz_close. * * A boolean. If TRUE piggyback is enabled for searches; If FALSE * piggyback is disabled. By default piggyback is enabled. * * Enabling piggyback is more efficient and usually saves a * network-round-trip for first time fetches of records. However, a * few Z39.50 servers do not support piggyback or they ignore element * set names. For those, piggyback should be disabled. * * A string that specifies character set to be used in Z39.50 * language and character set negotiation. Use strings such as: * ISO-8859-1, UTF-8, * UTF-16. * * Most Z39.50 servers do not support this feature (and thus, this is * ignored). Many servers use the ISO-8859-1 encoding for queries and * messages. MARC21/USMARC records are not affected by this setting. * * An integer that specifies the maximum byte size of all records * to be returned by a target during retrieval. See the * Z39.50 standard for more * information. * * This option is supported in PECL YAZ 1.0.5 or later. * * An integer that specifies the maximum byte size of a single record * to be returned by a target during retrieval. This * entity is referred to as Exceptional-record-size in the * Z39.50 standard. * * This option is supported in PECL YAZ 1.0.5 or later. * @return mixed A connection resource on success, FALSE on error. * @throws YazException * */ function yaz_connect(string $zurl, $options = null) { error_clear_last(); if ($options !== null) { $result = \yaz_connect($zurl, $options); } else { $result = \yaz_connect($zurl); } if ($result === false) { throw YazException::createFromPhpError(); } return $result; } /** * This function allows you to change databases within a session by * specifying one or more databases to be used in search, retrieval, etc. * - overriding databases specified in call to * yaz_connect. * * @param resource $id The connection resource returned by yaz_connect. * @param string $databases A string containing one or more databases. Multiple databases are * separated by a plus sign +. * @throws YazException * */ function yaz_database($id, string $databases): void { error_clear_last(); $result = \yaz_database($id, $databases); if ($result === false) { throw YazException::createFromPhpError(); } } /** * This function sets the element set name for retrieval. * * Call this function before yaz_search or * yaz_present to specify the element set name for * records to be retrieved. * * @param resource $id The connection resource returned by yaz_connect. * @param string $elementset Most servers support F (for full records) and * B (for brief records). * @throws YazException * */ function yaz_element($id, string $elementset): void { error_clear_last(); $result = \yaz_element($id, $elementset); if ($result === false) { throw YazException::createFromPhpError(); } } /** * This function prepares for retrieval of records after a successful search. * * The yaz_range function should be called prior to this * function to specify the range of records to be retrieved. * * @param resource $id The connection resource returned by yaz_connect. * @throws YazException * */ function yaz_present($id): void { error_clear_last(); $result = \yaz_present($id); if ($result === false) { throw YazException::createFromPhpError(); } } /** * yaz_search prepares for a search on the given * connection. * * Like yaz_connect this function is non-blocking and * only prepares for a search to be executed later when * yaz_wait is called. * * @param resource $id The connection resource returned by yaz_connect. * @param string $type This parameter represents the query type - only "rpn" * is supported now in which case the third argument specifies a Type-1 * query in prefix query notation. * @param string $query The RPN query is a textual representation of the Type-1 query as * defined by the Z39.50 standard. However, in the text representation * as used by YAZ a prefix notation is used, that is the operator * precedes the operands. The query string is a sequence of tokens where * white space is ignored unless surrounded by double quotes. Tokens beginning * with an at-character (@) are considered operators, * otherwise they are treated as search terms. * * You can find information about attributes at the * Z39.50 Maintenance Agency * site. * * If you would like to use a more friendly notation, * use the CCL parser - functions yaz_ccl_conf and * yaz_ccl_parse. * @throws YazException * */ function yaz_search($id, string $type, string $query): void { error_clear_last(); $result = \yaz_search($id, $type, $query); if ($result === false) { throw YazException::createFromPhpError(); } } /** * This function carries out networked (blocked) activity for outstanding * requests which have been prepared by the functions * yaz_connect, yaz_search, * yaz_present, yaz_scan and * yaz_itemorder. * * yaz_wait returns when all servers have either * completed all requests or aborted (in case of errors). * * @param array $options An associative array of options: * * * timeout * * * Sets timeout in seconds. If a server has not responded within the * timeout it is considered dead and yaz_wait * returns. The default value for timeout is 15 seconds. * * * * * event * * * A boolean. * * * * * * Sets timeout in seconds. If a server has not responded within the * timeout it is considered dead and yaz_wait * returns. The default value for timeout is 15 seconds. * * A boolean. * @return mixed Returns TRUE on success. * In event mode, returns resource. * @throws YazException * */ function yaz_wait(array &$options = null) { error_clear_last(); $result = \yaz_wait($options); if ($result === false) { throw YazException::createFromPhpError(); } return $result; }range); * * Copyright 2008: Paul Gregg * 10 January 2008 * Version: 1.2 * * Source website: http://www.pgregg.com/projects/php/ip_in_range/ * Version 1.2 * * This software is Donationware - if you feel you have benefited from * the use of this tool then please consider a donation. The value of * which is entirely left up to your discretion. * http://www.pgregg.com/donate/ * * Please do not remove this header, or source attibution from this file. */ /* * Modified by James Greene to include IPV6 support * (original version only supported IPV4). * 21 May 2012 */ // In order to simplify working with IP addresses (in binary) and their // netmasks, it is easier to ensure that the binary strings are padded // with zeros out to 32 characters - IP addresses are 32 bit numbers function rocket_decbin32($dec) { _deprecated_function( __FUNCTION__, '3.14' ); return str_pad(decbin($dec), 32, '0', STR_PAD_LEFT); } // This function takes 2 arguments, an IP address and a "range" in several // different formats. // Network ranges can be specified as: // 1. Wildcard format: 1.2.3.* // 2. CIDR format: 1.2.3/24 OR 1.2.3.4/255.255.255.0 // 3. Start-End IP format: 1.2.3.0-1.2.3.255 // The function will return true if the supplied IP is within the range. // Note little validation is done on the range inputs - it expects you to // use one of the above 3 formats. function rocket_ipv4_in_range($ip, $range) { _deprecated_function( __FUNCTION__, '3.14' ); if (strpos($range, '/') !== false) { // $range is in IP/NETMASK format list($range, $netmask) = explode('/', $range, 2); if (strpos($netmask, '.') !== false) { // $netmask is a 255.255.0.0 format $netmask = str_replace('*', '0', $netmask); $netmask_dec = ip2long($netmask); return ( (ip2long($ip) & $netmask_dec) == (ip2long($range) & $netmask_dec) ); } else { // $netmask is a CIDR size block // fix the range argument $x = explode('.', $range); while(count($x)<4) $x[] = '0'; list($a,$b,$c,$d) = $x; $range = sprintf("%u.%u.%u.%u", empty($a)?'0':$a, empty($b)?'0':$b,empty($c)?'0':$c,empty($d)?'0':$d); $range_dec = ip2long($range); $ip_dec = ip2long($ip); # Strategy 1 - Create the netmask with 'netmask' 1s and then fill it to 32 with 0s #$netmask_dec = bindec(str_pad('', $netmask, '1') . str_pad('', 32-$netmask, '0')); # Strategy 2 - Use math to create it $wildcard_dec = pow(2, (32-$netmask)) - 1; $netmask_dec = ~ $wildcard_dec; return (($ip_dec & $netmask_dec) == ($range_dec & $netmask_dec)); } } else { // range might be 255.255.*.* or 1.2.3.0-1.2.3.255 if (strpos($range, '*') !==false) { // a.b.*.* format // Just convert to A-B format by setting * to 0 for A and 255 for B $lower = str_replace('*', '0', $range); $upper = str_replace('*', '255', $range); $range = "$lower-$upper"; } if (strpos($range, '-')!==false) { // A-B format list($lower, $upper) = explode('-', $range, 2); $lower_dec = (float)sprintf("%u",ip2long($lower)); $upper_dec = (float)sprintf("%u",ip2long($upper)); $ip_dec = (float)sprintf("%u",ip2long($ip)); return ( ($ip_dec>=$lower_dec) && ($ip_dec<=$upper_dec) ); } return false; } } function rocket_ip2long6($ip) { _deprecated_function( __FUNCTION__, '3.14' ); if (substr_count($ip, '::')) { $ip = str_replace('::', str_repeat(':0000', 8 - substr_count($ip, ':')) . ':', $ip); } $ip = explode(':', $ip); $r_ip = ''; foreach ($ip as $v) { $r_ip .= str_pad( base_convert( preg_replace("/[^0-9a-fA-F]/", "", $v ), 16, 2 ), 16, 0, STR_PAD_LEFT ); } return base_convert($r_ip, 2, 10); } // Get the ipv6 full format and return it as a decimal value. function get_rocket_ipv6_full($ip) { _deprecated_function( __FUNCTION__, '3.14' ); $pieces = explode ("/", $ip, 2); $left_piece = $pieces[0]; $right_piece = null; if (count($pieces) > 1) $right_piece = $pieces[1]; // Extract out the main IP pieces $ip_pieces = explode("::", $left_piece, 2); $main_ip_piece = $ip_pieces[0]; $last_ip_piece = ""; if (count($ip_pieces) > 1) $last_ip_piece = $ip_pieces[1]; // Pad out the shorthand entries. $main_ip_pieces = explode(":", $main_ip_piece); foreach($main_ip_pieces as $key=>$val) { $main_ip_pieces[$key] = str_pad($main_ip_pieces[$key], 4, "0", STR_PAD_LEFT); } // Check to see if the last IP block (part after ::) is set $last_piece = ""; $size = count($main_ip_pieces); if (trim($last_ip_piece) != "") { $last_piece = str_pad($last_ip_piece, 4, "0", STR_PAD_LEFT); // Build the full form of the IPV6 address considering the last IP block set for ($i = $size; $i < 7; $i++) { $main_ip_pieces[$i] = "0000"; } $main_ip_pieces[7] = $last_piece; } else { // Build the full form of the IPV6 address for ($i = $size; $i < 8; $i++) { $main_ip_pieces[$i] = "0000"; } } // Rebuild the final long form IPV6 address $final_ip = implode(":", $main_ip_pieces); return rocket_ip2long6($final_ip); } // Determine whether the IPV6 address is within range. // $ip is the IPV6 address in decimal format to check if its within the IP range created by the cloudflare IPV6 address, $range_ip. // $ip and $range_ip are converted to full IPV6 format. // Returns true if the IPV6 address, $ip, is within the range from $range_ip. False otherwise. function rocket_ipv6_in_range($ip, $range_ip) { _deprecated_function( __FUNCTION__, '3.14' ); $pieces = explode ("/", $range_ip, 2); $left_piece = $pieces[0]; $right_piece = $pieces[1]; // Extract out the main IP pieces $ip_pieces = explode("::", $left_piece, 2); $main_ip_piece = $ip_pieces[0]; $last_ip_piece = $ip_pieces[1]; // Pad out the shorthand entries. $main_ip_pieces = explode(":", $main_ip_piece); foreach($main_ip_pieces as $key=>$val) { $main_ip_pieces[$key] = str_pad($main_ip_pieces[$key], 4, "0", STR_PAD_LEFT); } // Create the first and last pieces that will denote the IPV6 range. $first = $main_ip_pieces; $last = $main_ip_pieces; // Check to see if the last IP block (part after ::) is set $last_piece = ""; $size = count($main_ip_pieces); if (trim($last_ip_piece) != "") { $last_piece = str_pad($last_ip_piece, 4, "0", STR_PAD_LEFT); // Build the full form of the IPV6 address considering the last IP block set for ($i = $size; $i < 7; $i++) { $first[$i] = "0000"; $last[$i] = "ffff"; } $main_ip_pieces[7] = $last_piece; } else { // Build the full form of the IPV6 address for ($i = $size; $i < 8; $i++) { $first[$i] = "0000"; $last[$i] = "ffff"; } } // Rebuild the final long form IPV6 address $first = rocket_ip2long6(implode(":", $first)); $last = rocket_ip2long6(implode(":", $last)); $in_range = ($ip >= $first && $ip <= $last); return $in_range; } /** * Filter plugin fetching API results to inject Imagify * * @since 2.10.7 * @since 3.14.2 deprecated * @author Remy Perona * * @param object|WP_Error $result Response object or WP_Error. * @param string $action The type of information being requested from the Plugin Install API. * @param object $args Plugin API arguments. * * @return array Updated array of results */ function rocket_add_imagify_api_result( $result, $action, $args ) { if ( empty( $args->browse ) ) { return $result; } if ( 'featured' !== $args->browse && 'recommended' !== $args->browse && 'popular' !== $args->browse ) { return $result; } if ( ! isset( $result->info['page'] ) || 1 < $result->info['page'] ) { return $result; } if ( is_plugin_active( 'imagify/imagify.php' ) || is_plugin_active_for_network( 'imagify/imagify.php' ) ) { return $result; } // grab all slugs from the api results. $result_slugs = wp_list_pluck( $result->plugins, 'slug' ); if ( in_array( 'imagify', $result_slugs, true ) ) { return $result; } $query_args = [ 'slug' => 'imagify', 'fields' => [ 'icons' => true, 'active_installs' => true, 'short_description' => true, 'group' => true, ], ]; $imagify_data = plugins_api( 'plugin_information', $query_args ); if ( is_wp_error( $imagify_data ) ) { return $result; } if ( 'featured' === $args->browse ) { array_push( $result->plugins, $imagify_data ); } else { array_unshift( $result->plugins, $imagify_data ); } return $result; }