212 lines
5.3 KiB
PHP
212 lines
5.3 KiB
PHP
<?php
|
|
/*
|
|
The NuSOAP project home is:
|
|
http://sourceforge.net/projects/nusoap/
|
|
|
|
The primary support for NuSOAP is the mailing list:
|
|
nusoap-general@lists.sourceforge.net
|
|
*/
|
|
if (!defined('W3TC')) {
|
|
die();
|
|
}
|
|
|
|
/**
|
|
* caches instances of the wsdl class
|
|
*
|
|
* @author Scott Nichol <snichol@users.sourceforge.net>
|
|
* @author Ingo Fischer <ingo@apollon.de>
|
|
* @version $Id: class.wsdlcache.php,v 1.7 2007/04/17 16:34:03 snichol Exp $
|
|
* @access public
|
|
*/
|
|
class nusoap_wsdlcache {
|
|
/**
|
|
* @var resource
|
|
* @access private
|
|
*/
|
|
var $fplock;
|
|
/**
|
|
* @var integer
|
|
* @access private
|
|
*/
|
|
var $cache_lifetime;
|
|
/**
|
|
* @var string
|
|
* @access private
|
|
*/
|
|
var $cache_dir;
|
|
/**
|
|
* @var string
|
|
* @access public
|
|
*/
|
|
var $debug_str = '';
|
|
|
|
/**
|
|
* constructor
|
|
*
|
|
* @param string $cache_dir directory for cache-files
|
|
* @param integer $cache_lifetime lifetime for caching-files in seconds or 0 for unlimited
|
|
* @access public
|
|
*/
|
|
function __construct($cache_dir='.', $cache_lifetime=0) {
|
|
$this->fplock = array();
|
|
$this->cache_dir = $cache_dir != '' ? $cache_dir : '.';
|
|
$this->cache_lifetime = $cache_lifetime;
|
|
}
|
|
|
|
/**
|
|
* creates the filename used to cache a wsdl instance
|
|
*
|
|
* @param string $wsdl The URL of the wsdl instance
|
|
* @return string The filename used to cache the instance
|
|
* @access private
|
|
*/
|
|
function createFilename($wsdl) {
|
|
return $this->cache_dir.'/wsdlcache-' . md5($wsdl);
|
|
}
|
|
|
|
/**
|
|
* adds debug data to the class level debug string
|
|
*
|
|
* @param string $string debug data
|
|
* @access private
|
|
*/
|
|
function debug($string){
|
|
$this->debug_str .= get_class($this).": $string\n";
|
|
}
|
|
|
|
/**
|
|
* gets a wsdl instance from the cache
|
|
*
|
|
* @param string $wsdl The URL of the wsdl instance
|
|
* @return object wsdl The cached wsdl instance, null if the instance is not in the cache
|
|
* @access public
|
|
*/
|
|
function get($wsdl) {
|
|
$filename = $this->createFilename($wsdl);
|
|
if ($this->obtainMutex($filename, "r")) {
|
|
// check for expired WSDL that must be removed from the cache
|
|
if ($this->cache_lifetime > 0) {
|
|
if (file_exists($filename) && (time() - filemtime($filename) > $this->cache_lifetime)) {
|
|
unlink($filename);
|
|
$this->debug("Expired $wsdl ($filename) from cache");
|
|
$this->releaseMutex($filename);
|
|
return null;
|
|
}
|
|
}
|
|
// see what there is to return
|
|
if (!file_exists($filename)) {
|
|
$this->debug("$wsdl ($filename) not in cache (1)");
|
|
$this->releaseMutex($filename);
|
|
return null;
|
|
}
|
|
$fp = @fopen($filename, "r");
|
|
if ($fp) {
|
|
$s = implode("", @file($filename));
|
|
fclose($fp);
|
|
$this->debug("Got $wsdl ($filename) from cache");
|
|
} else {
|
|
$s = null;
|
|
$this->debug("$wsdl ($filename) not in cache (2)");
|
|
}
|
|
$this->releaseMutex($filename);
|
|
return (!is_null($s)) ? unserialize($s) : null;
|
|
} else {
|
|
$this->debug("Unable to obtain mutex for $filename in get");
|
|
}
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* obtains the local mutex
|
|
*
|
|
* @param string $filename The Filename of the Cache to lock
|
|
* @param string $mode The open-mode ("r" or "w") or the file - affects lock-mode
|
|
* @return boolean Lock successfully obtained ?!
|
|
* @access private
|
|
*/
|
|
function obtainMutex($filename, $mode) {
|
|
if (isset($this->fplock[md5($filename)])) {
|
|
$this->debug("Lock for $filename already exists");
|
|
return false;
|
|
}
|
|
$this->fplock[md5($filename)] = fopen($filename.".lock", "w");
|
|
if ($mode == "r") {
|
|
return flock($this->fplock[md5($filename)], LOCK_SH);
|
|
} else {
|
|
return flock($this->fplock[md5($filename)], LOCK_EX);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* adds a wsdl instance to the cache
|
|
*
|
|
* @param object wsdl $wsdl_instance The wsdl instance to add
|
|
* @return boolean WSDL successfully cached
|
|
* @access public
|
|
*/
|
|
function put($wsdl_instance) {
|
|
$filename = $this->createFilename($wsdl_instance->wsdl);
|
|
$s = serialize($wsdl_instance);
|
|
if ($this->obtainMutex($filename, "w")) {
|
|
$fp = fopen($filename, "w");
|
|
if (! $fp) {
|
|
$this->debug("Cannot write $wsdl_instance->wsdl ($filename) in cache");
|
|
$this->releaseMutex($filename);
|
|
return false;
|
|
}
|
|
fputs($fp, $s);
|
|
fclose($fp);
|
|
$this->debug("Put $wsdl_instance->wsdl ($filename) in cache");
|
|
$this->releaseMutex($filename);
|
|
return true;
|
|
} else {
|
|
$this->debug("Unable to obtain mutex for $filename in put");
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* releases the local mutex
|
|
*
|
|
* @param string $filename The Filename of the Cache to lock
|
|
* @return boolean Lock successfully released
|
|
* @access private
|
|
*/
|
|
function releaseMutex($filename) {
|
|
$ret = flock($this->fplock[md5($filename)], LOCK_UN);
|
|
fclose($this->fplock[md5($filename)]);
|
|
unset($this->fplock[md5($filename)]);
|
|
if (! $ret) {
|
|
$this->debug("Not able to release lock for $filename");
|
|
}
|
|
return $ret;
|
|
}
|
|
|
|
/**
|
|
* removes a wsdl instance from the cache
|
|
*
|
|
* @param string $wsdl The URL of the wsdl instance
|
|
* @return boolean Whether there was an instance to remove
|
|
* @access public
|
|
*/
|
|
function remove($wsdl) {
|
|
$filename = $this->createFilename($wsdl);
|
|
if (!file_exists($filename)) {
|
|
$this->debug("$wsdl ($filename) not in cache to be removed");
|
|
return false;
|
|
}
|
|
// ignore errors obtaining mutex
|
|
$this->obtainMutex($filename, "w");
|
|
$ret = unlink($filename);
|
|
$this->debug("Removed ($ret) $wsdl ($filename) from cache");
|
|
$this->releaseMutex($filename);
|
|
return $ret;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* For backward compatibility
|
|
*/
|
|
class wsdlcache extends nusoap_wsdlcache {
|
|
}
|