wincache_ucache_info(3) [php man page]

WINCACHE_UCACHE_INFO(3) 						 1						   WINCACHE_UCACHE_INFO(3)

wincache_ucache_info - Retrieves information about data stored in the user cache

SYNOPSIS

       array wincache_ucache_info ([bool  $summaryonly = false], [string  $key = NULL])

DESCRIPTION

	Retrieves information about data stored in the user cache.

PARAMETERS

	      o $summaryonly
		- Controls whether the returned array will contain information about individual cache entries along with the user cache summary.

	      o $key
		-  The	key  of  an  entry  in the user cache. If specified then the returned array will contain information only about that cache
		entry. If not specified and $summaryonly is set to FALSE then the returned array will contain information about all entries in the
		cache.

RETURN VALUES

	Array of meta data about user cache or FALSE on failure

	The array returned by this function contains the following elements:

	      o total_cache_uptime - total time in seconds that the user cache has been active

	      o total_item_count - total number of elements that are currently in the user cache

	      o is_local_cache - true is the cache metadata is for a local cache instance, false if the metadata is for the global cache

	      o total_hit_count - number of times the data has been served from the cache

	      o total_miss_count - number of times the data has not been found in the cache

	      o ucache_entries - an array that contains the information about all the cached items:

		     o key_name - name of the key which is used to store the data

		     o value_type - type of value stored by the key

		     o use_time - time in seconds since the file has been accessed in the opcode cache

		     o last_check - time in seconds since the file has been checked for modifications

		     o is_session - indicates if the data is a session variable

		     o ttl_seconds - time remaining for the data to live in the cache, 0 meaning infinite

		     o age_seconds - time elapsed from the time data has been added in the cache

		     o hitcount - number of times data has been served from the cache

EXAMPLES

       Example #1

	      Using wincache_ucache_info(3)

	      <?php
	      wincache_ucache_get('green');
	      wincache_ucache_set('green', 2922);
	      wincache_ucache_get('green');
	      wincache_ucache_get('green');
	      wincache_ucache_get('green');
	      print_r(wincache_ucache_info());
	      ?>

	      The above example will output:

	      Array
	      ( ["total_cache_uptime"] => int(0)
		["is_local_cache"] => bool(false)
		["total_item_count"] => int(1)
		["total_hit_count"] => int(3)
		["total_miss_count"] => int(1)
		["ucache_entries"] => Array(1)
		  ( [1] => Array(6)
		    (
		      ["key_name"] => string(5) "green"
		      ["value_type"] => string(4) "long"
		      ["is_session"] => int(0)
		      ["ttl_seconds"] => int(0)
		      ["age_seconds"] => int(0)
		      ["hitcount"] => int(3)
		     )
		  )
	      )

SEE ALSO

       wincache_fcache_meminfo(3),   wincache_ocache_fileinfo(3),  wincache_ocache_meminfo(3),	wincache_rplist_meminfo(3),  wincache_rplist_file-
       info(3), wincache_refresh_if_changed(3), wincache_ucache_meminfo(3), wincache_scache_info(3), wincache_scache_meminfo(3).

PHP Documentation Group 												   WINCACHE_UCACHE_INFO(3)

Check Out this Related Man Page

WINCACHE_REFRESH_IF_CHANGED(3)						 1					    WINCACHE_REFRESH_IF_CHANGED(3)

wincache_refresh_if_changed - Refreshes the cache entries for the cached files

SYNOPSIS

       bool wincache_refresh_if_changed ([array  $files = NULL])

DESCRIPTION

	Refreshes  the	cache entries for the files, whose names were passed in the input argument. If no argument is specified then refreshes all
       the entries in the cache.

PARAMETERS

	      o $files
		- An array of file names for files that need to be refreshed. An absolute or relative file paths can be used.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

	WinCache performs regular checks on the cached files to ensure that if any file has changed then the corresponding entry in the  cache	is
       updated.  By  default this check is performed every 30 seconds. If, for example, a PHP script updates another PHP script where the applica-
       tion's configuration settings are stored, then it may happen that after the configuration settings have been saved to a file, the  applica-
       tion  is  still	using  old  settings for some time until the cache is refreshed. In those cases it may be preferrable to refresh the cache
       right after the file has been changed. The following example shows how this can be done.

       Example #1

	      A wincache_refresh_if_changed(3) example

	      <?php
	      $filename = 'C:inetpubwwwrootconfig.php';
	      $handle = fopen($filename, 'w+');
	      if ($handle === FALSE) die('Failed to open file '.$filename.' for writing');
	      fwrite($handle, '<?php $setting=something; ?>');
	      fclose($handle);
	      wincache_refresh_if_changed(array($filename));
	      ?>

SEE ALSO

       wincache_fcache_fileinfo(3),  wincache_fcache_meminfo(3),  wincache_ocache_fileinfo(3),	wincache_ocache_meminfo(3),  wincache_rplist_file-
       info(3), wincache_rplist_meminfo(3), wincache_ucache_meminfo(3), wincache_ucache_info(3).

PHP Documentation Group 											    WINCACHE_REFRESH_IF_CHANGED(3)

Linux and UNIX Man Pages

wincache_ucache_info(3) [php man page]

Check Out this Related Man Page