Changeset 12128 for trunk/wp-includes/functions.php

Timestamp:

10/29/2009 09:53:57 PM (17 years ago)

Author:

ryan

Message:

Introduce get/set/delete_site_transient(). Make theme_roots a site transient.

File:

• trunk/wp-includes/functions.php (modified) (2 diffs)

trunk/wp-includes/functions.php

@@ -3191 +3191 @@
 }
 
+function delete_site_option( $key ) {
+        $result = delete_option($key);
+        do_action( "delete_site_option_{$key}", $key );
+        return $result;
+}
+
 // expects $key, $value not to be SQL escaped
 function update_site_option( $key, $value ) {
@@ -3198 +3204 @@
         do_action( "update_site_option_{$key}", $key, $value );
         return $result;
+}
+
+/**
+ * Delete a site transient
+ *
+ * @since 2.890
+ * @package WordPress
+ * @subpackage Transient
+ *
+ * @param string $transient Transient name. Expected to not be SQL-escaped
+ * @return bool true if successful, false otherwise
+ */
+function delete_site_transient($transient) {
+        global $_wp_using_ext_object_cache, $wpdb;
+
+        if ( $_wp_using_ext_object_cache ) {
+                return wp_cache_delete($transient, 'site-transient');
+        } else {
+                $transient = '_site_transient_' . esc_sql($transient);
+                return delete_site_option($transient);
+        }
+}
+
+/**
+ * Get the value of a site transient
+ *
+ * If the transient does not exist or does not have a value, then the return value
+ * will be false.
+ * 
+ * @since 2.9.0
+ * @package WordPress
+ * @subpackage Transient
+ *
+ * @param string $transient Transient name. Expected to not be SQL-escaped
+ * @return mixed Value of transient
+ */
+function get_site_transient($transient) {
+        global $_wp_using_ext_object_cache, $wpdb;
+
+        $pre = apply_filters( 'pre_site_transient_' . $transient, false );
+        if ( false !== $pre )
+                return $pre;
+
+        if ( $_wp_using_ext_object_cache ) {
+                $value = wp_cache_get($transient, 'site-transient');
+        } else {
+                $transient_option = '_site_transient_' . esc_sql($transient);
+                $transient_timeout = '_site_transient_timeout_' . esc_sql($transient);
+                if ( get_site_option($transient_timeout) < time() ) {
+                        delete_site_option($transient_option);
+                        delete_site_option($transient_timeout);
+                        return false;
+                }
+
+                $value = get_site_option($transient_option);
+        }
+
+        return apply_filters('site_transient_' . $transient, $value);
+}
+
+/**
+ * Set/update the value of a site transient
+ *
+ * You do not need to serialize values, if the value needs to be serialize, then
+ * it will be serialized before it is set.
+ *
+ * @since 2.9.0
+ * @package WordPress
+ * @subpackage Transient
+ *
+ * @param string $transient Transient name. Expected to not be SQL-escaped
+ * @param mixed $value Transient value.
+ * @param int $expiration Time until expiration in seconds, default 0
+ * @return bool False if value was not set and true if value was set.
+ */
+function set_site_transient($transient, $value, $expiration = 0) {
+        global $_wp_using_ext_object_cache, $wpdb;
+
+        if ( $_wp_using_ext_object_cache ) {
+                return wp_cache_set($transient, $value, 'site-transient', $expiration);
+        } else {
+                $transient_timeout = '_site_transient_timeout_' . $transient;
+                $transient = '_site_transient_' . $transient;
+                $safe_transient = esc_sql($transient);
+                if ( false === get_site_option( $safe_transient ) ) {
+                        if ( 0 != $expiration )
+                                add_site_option($transient_timeout, time() + $expiration);
+                        return add_site_option($transient, $value);
+                } else {
+                        if ( 0 != $expiration )
+                                update_site_option($transient_timeout, time() + $expiration);
+                        return update_site_option($transient, $value);
+                }
+        }
 }