From 061d1a0b00c08b8bdfe3a414a15f9cc0a1b1f041 Mon Sep 17 00:00:00 2001
From: Eric Rasmussen <erasmussen2@unl.edu>
Date: Fri, 8 Oct 2010 16:49:23 +0000
Subject: [PATCH] Add UNL_Cache_Lite to lib
---
lib/.pear2registry | Bin 345088 -> 351232 bytes
.../UNL_Cache_Lite/0.1.0-info.xml | 72 ++
lib/data/UNL_Cache_Lite/LICENSE | 458 ++++++++++
lib/data/UNL_Cache_Lite/TODO | 46 +
lib/docs/UNL_Cache_Lite/docs/examples | 254 ++++++
lib/docs/UNL_Cache_Lite/docs/technical | 28 +
lib/downloads/UNL_Cache_Lite-0.1.0.tgz | Bin 0 -> 20511 bytes
lib/php/UNL/Cache/Lite.php | 844 ++++++++++++++++++
lib/php/UNL/Cache/Lite/File.php | 91 ++
lib/php/UNL/Cache/Lite/Function.php | 209 +++++
lib/php/UNL/Cache/Lite/NestedOutput.php | 55 ++
lib/php/UNL/Cache/Lite/Output.php | 70 ++
12 files changed, 2127 insertions(+)
create mode 100644 lib/.xmlregistry/packages/pear.unl.edu/UNL_Cache_Lite/0.1.0-info.xml
create mode 100644 lib/data/UNL_Cache_Lite/LICENSE
create mode 100644 lib/data/UNL_Cache_Lite/TODO
create mode 100644 lib/docs/UNL_Cache_Lite/docs/examples
create mode 100644 lib/docs/UNL_Cache_Lite/docs/technical
create mode 100644 lib/downloads/UNL_Cache_Lite-0.1.0.tgz
create mode 100644 lib/php/UNL/Cache/Lite.php
create mode 100644 lib/php/UNL/Cache/Lite/File.php
create mode 100644 lib/php/UNL/Cache/Lite/Function.php
create mode 100644 lib/php/UNL/Cache/Lite/NestedOutput.php
create mode 100644 lib/php/UNL/Cache/Lite/Output.php
diff --git a/lib/.pear2registry b/lib/.pear2registry
index a91563c82a9051144ca7f6c4b13e488bced7b4a3..3346b2f109d006e419fc1e3cc1a10f10d087e9c2 100644
GIT binary patch
delta 4385
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
L<n{SO0pEWCWIHm)
delta 1697
zcmah}X-rgC6u#%2dxrsMU_h`4%*a~7m63{~0s}<|Ra8W)Y22s~i=q&L8k=GmYebC-
z6!f5_MnP+8qk@z2Ds`>K<%fz})!<&+T5FA_Nli6s@3cvOG)+v-dpYke-}}yYzI$uF
z38`5XQXdXM9TE3^f~{CBs01%ie>zD&(MoEe98Z|}ZETFRMSH6KR@ei`B_zfQAs~$2
z$K@Vd{9=^)vw^!q>D|Wb1Li?=W7fbZsOQ}-+`Mm)G)Gu4lBkDv(`uSegRq<=Uc-Hu
zgOOO@7HC6HWb!@mv!Ijc7VV?;9^1%Qpnn<bagMrJ?69I!&|Nx6YpI;_C=OrYEo{c6
z=)`>N@&wuf(Bo{q2(P36MXl9t#esru(tcV+rIbri_#At%39E1*j>8RsD$5gTI{}T(
z)^JaD=b_g^cCD`JlO{x(_!<&m3kG2=Ayv~(alA3m7R_mi5YLGyQ`zQ_7Gt*)3Q&He
z+zZ&{ghD=t(q<|utSp3P&YuiL+`W+$JD7sGy-Uh4*yN{`HH+~=#}OC-UunfQkS{Ic
z(6=C+bDS`pYyO}BBOw{CfUHpNnO@}CT=P8zAZ%q@63pd;`Owrk5@cwwSu7Pg?m;0u
zz{Pk|EATmoPSQ}WRE(DMl{=54QgJ#TI6+o~?QBoQYUTD(%YD4##ccbG`tYnn<YRoA
zL4_a-l)E2qb5R<%r=c(NSXJ6N1>k->`e@!wn!UI#njio+VkKJfF-@Wl@1W506^oR+
zz)LroZST-<uZi;5H5`_Bvk6{7J~8WTYN>MP|MQQURtn{r*{Zi6-W8^~O3z;4tz*@A
zo|CD3x$GMG`j&rC4&UjC^Smex7xwZmQSRIj96Gh4nA6kos297tv2MUP2kOj6Jkf8l
zQ#^sq7>LX8ckQoT_?)J)tr?@)<-!u4)2b^g&ct+Iz4Wp>MlDb0s4~jq@}rn<Jj&2r
z_o8<4#2>VfTQ*}aK9VM-)J&Y6Stx5F{lz+=qX)uZKD0p(M&WGShS%v0Dx>Xmfn$$j
zi81pyR#4|Dlo7#Zs1tMmFX37o4RvsbiYZw8d<htJKWeY01c--1JcJl1f;G?uKVyh?
zZ!I3fr!<Tf(Js0`r^HCwLl+0fDtlZ%tXfn$L?=mn$Cn(u$xIf`xR2p{do}p*nbXpb
zYj0rh-l8K;g~!Esm(MO*lB@>n9UUjo&cF7PAtu*<2L2BMMTc?Y0mcB&h>&B9GiFMK
z&WF0D*g%mbbbKgwh)d#6coXJ83!FtnZ81Ecl^;qAINnS<_;8R?Mz<d&0=GoS(MIZI
zbs7wlg<kdwGefMmW3wO@mceCAz?Jw5jiHUSULUw=Top>wxcvq6+Hh01;dU5hdRx=R
zFZ*IT*B=72QP!6>_y+|*gTP^!hb7pCSII^>Mrb_cc`uzIMneKs_?rL|1SV+J4}f(=
zvU{Ahe_WM&TFAnDzOzni_~@lf<ReL-sG@kWkuZvSRJfn$Cv?<`r%(WU(V~yoWlEtI
zO~EM7R`nofD7W+9^Ag1EYe@2|R8(A+O$Em632FxzGK*eZi4j+YMXb{nhg^7u?XU;l
z6YIc%MU;fU(Z}Keb?J&DeW9<&%~Jj2rZzqqG>rE?Ba2C#*Siw=;9)tOZ#krY9~>f3
zKS3FK-Ne6}TUorYob7g*%%u)}J3V&D0u;x%qmrWe)h-#%-Cs(@bB;=Bf_a+$KJGq=
ziC!&}+1W$`%=l1DnW*|BI~;PN>Dv+7Tw}fFis5rs<xiR{*V$zQ7uaPQLJ~WoRc2?T
tl%eK%uu;Q6K3hi0v$}*swaqEgXiib3CKJGZ0sD=>>C_HJSBA>QzW@wd&rSdU
diff --git a/lib/.xmlregistry/packages/pear.unl.edu/UNL_Cache_Lite/0.1.0-info.xml b/lib/.xmlregistry/packages/pear.unl.edu/UNL_Cache_Lite/0.1.0-info.xml
new file mode 100644
index 00000000..2b502203
--- /dev/null
+++ b/lib/.xmlregistry/packages/pear.unl.edu/UNL_Cache_Lite/0.1.0-info.xml
@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<package xmlns="http://pear.php.net/dtd/package-2.0" xmlns:tasks="http://pear.php.net/dtd/tasks-1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" packagerversion="1.9.0" version="2.0" xsi:schemaLocation="http://pear.php.net/dtd/tasks-1.0 http://pear.php.net/dtd/tasks-1.0.xsd http://pear.php.net/dtd/package-2.0 http://pear.php.net/dtd/package-2.0.xsd">
+ <name>UNL_Cache_Lite</name>
+ <channel>pear.unl.edu</channel>
+ <summary>Basic caching library</summary>
+ <description>This is a port of the Cache_Lite package from PEAR, with support for PHP 5 and
+exceptions.
+This package is a little cache system optimized for file containers. It is fast
+and safe (because it uses file locking and/or anti-corruption tests).</description>
+ <lead>
+ <name>Brett Bieber</name>
+ <user>saltybeagle</user>
+ <email>brett.bieber@gmail.com</email>
+ <active>yes</active>
+ </lead>
+ <date>2010-10-08</date>
+ <time>11:49:16</time>
+ <version>
+ <release>0.1.0</release>
+ <api>0.1.0</api>
+ </version>
+ <stability>
+ <release>beta</release>
+ <api>beta</api>
+ </stability>
+ <license uri="http://www.gnu.org/licenses/lgpl-3.0.txt">LGPL</license>
+ <notes>
+Port of cache lite, remove PEAR dependency, use exceptions instead of PEAR_Error.
+ </notes>
+ <contents>
+ <dir name="/">
+ <file baseinstalldir="/" md5sum="ea88bd9816a106e30ac2939a28679fc7" name="UNL/Cache/Lite/Output.php" role="php"/>
+ <file baseinstalldir="/" md5sum="537413f3d9e949be31a1dd9f42c1dd5c" name="UNL/Cache/Lite/NestedOutput.php" role="php"/>
+ <file baseinstalldir="/" md5sum="95bccdc3a6ec0d54ab4adf3ce03d4b55" name="UNL/Cache/Lite/Function.php" role="php"/>
+ <file baseinstalldir="/" md5sum="33a3fc682d63cef8f5cf126637001662" name="UNL/Cache/Lite/File.php" role="php"/>
+ <file baseinstalldir="/" md5sum="7f02fa5030fe224535a8849aa0d98741" name="UNL/Cache/Lite.php" role="php"/>
+ <file baseinstalldir="/" md5sum="4c638b951a7c8a4dcb94f10abf1d818b" name="TODO" role="data"/>
+ <file baseinstalldir="/" md5sum="085e7fb76fb3fa8ba9e9ed0ce95a43f9" name="LICENSE" role="data"/>
+ <file baseinstalldir="/" md5sum="934071f21c17611811e01396ca604c79" name="docs/technical" role="doc"/>
+ <file baseinstalldir="/" md5sum="516beafae66ea4b9fd7d29ab9c90845d" name="docs/examples" role="doc"/>
+ </dir>
+ </contents>
+ <dependencies>
+ <required>
+ <php>
+ <min>5.1.2</min>
+ </php>
+ <pearinstaller>
+ <min>1.5.4</min>
+ </pearinstaller>
+ </required>
+ </dependencies>
+ <phprelease>
+ <changelog>
+ <release>
+ <version>
+ <release>0.1.0</release>
+ <api>0.1.0</api>
+ </version>
+ <stability>
+ <release>beta</release>
+ <api>beta</api>
+ </stability>
+ <date>2009-10-20</date>
+ <license uri="http://www.gnu.org/licenses/lgpl-3.0.txt">LGPL</license>
+ <notes>
+Port of cache lite, remove PEAR dependency, use exceptions instead of PEAR_Error.
+ </notes>
+ </release>
+ </changelog>
+ </phprelease>
+</package>
diff --git a/lib/data/UNL_Cache_Lite/LICENSE b/lib/data/UNL_Cache_Lite/LICENSE
new file mode 100644
index 00000000..27950e8d
--- /dev/null
+++ b/lib/data/UNL_Cache_Lite/LICENSE
@@ -0,0 +1,458 @@
+ GNU LESSER GENERAL PUBLIC LICENSE
+ Version 2.1, February 1999
+
+ Copyright (C) 1991, 1999 Free Software Foundation, Inc.
+ 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+[This is the first released version of the Lesser GPL. It also counts
+ as the successor of the GNU Library Public License, version 2, hence
+ the version number 2.1.]
+
+ Preamble
+
+ The licenses for most software are designed to take away your
+freedom to share and change it. By contrast, the GNU General Public
+Licenses are intended to guarantee your freedom to share and change
+free software--to make sure the software is free for all its users.
+
+ This license, the Lesser General Public License, applies to some
+specially designated software packages--typically libraries--of the
+Free Software Foundation and other authors who decide to use it. You
+can use it too, but we suggest you first think carefully about whether
+this license or the ordinary General Public License is the better
+strategy to use in any particular case, based on the explanations below.
+
+ When we speak of free software, we are referring to freedom of use,
+not price. Our General Public Licenses are designed to make sure that
+you have the freedom to distribute copies of free software (and charge
+for this service if you wish); that you receive source code or can get
+it if you want it; that you can change the software and use pieces of
+it in new free programs; and that you are informed that you can do
+these things.
+
+ To protect your rights, we need to make restrictions that forbid
+distributors to deny you these rights or to ask you to surrender these
+rights. These restrictions translate to certain responsibilities for
+you if you distribute copies of the library or if you modify it.
+
+ For example, if you distribute copies of the library, whether gratis
+or for a fee, you must give the recipients all the rights that we gave
+you. You must make sure that they, too, receive or can get the source
+code. If you link other code with the library, you must provide
+complete object files to the recipients, so that they can relink them
+with the library after making changes to the library and recompiling
+it. And you must show them these terms so they know their rights.
+
+ We protect your rights with a two-step method: (1) we copyright the
+library, and (2) we offer you this license, which gives you legal
+permission to copy, distribute and/or modify the library.
+
+ To protect each distributor, we want to make it very clear that
+there is no warranty for the free library. Also, if the library is
+modified by someone else and passed on, the recipients should know
+that what they have is not the original version, so that the original
+author's reputation will not be affected by problems that might be
+introduced by others.
+
+ Finally, software patents pose a constant threat to the existence of
+any free program. We wish to make sure that a company cannot
+effectively restrict the users of a free program by obtaining a
+restrictive license from a patent holder. Therefore, we insist that
+any patent license obtained for a version of the library must be
+consistent with the full freedom of use specified in this license.
+
+ Most GNU software, including some libraries, is covered by the
+ordinary GNU General Public License. This license, the GNU Lesser
+General Public License, applies to certain designated libraries, and
+is quite different from the ordinary General Public License. We use
+this license for certain libraries in order to permit linking those
+libraries into non-free programs.
+
+ When a program is linked with a library, whether statically or using
+a shared library, the combination of the two is legally speaking a
+combined work, a derivative of the original library. The ordinary
+General Public License therefore permits such linking only if the
+entire combination fits its criteria of freedom. The Lesser General
+Public License permits more lax criteria for linking other code with
+the library.
+
+ We call this license the "Lesser" General Public License because it
+does Less to protect the user's freedom than the ordinary General
+Public License. It also provides other free software developers Less
+of an advantage over competing non-free programs. These disadvantages
+are the reason we use the ordinary General Public License for many
+libraries. However, the Lesser license provides advantages in certain
+special circumstances.
+
+ For example, on rare occasions, there may be a special need to
+encourage the widest possible use of a certain library, so that it becomes
+a de-facto standard. To achieve this, non-free programs must be
+allowed to use the library. A more frequent case is that a free
+library does the same job as widely used non-free libraries. In this
+case, there is little to gain by limiting the free library to free
+software only, so we use the Lesser General Public License.
+
+ In other cases, permission to use a particular library in non-free
+programs enables a greater number of people to use a large body of
+free software. For example, permission to use the GNU C Library in
+non-free programs enables many more people to use the whole GNU
+operating system, as well as its variant, the GNU/Linux operating
+system.
+
+ Although the Lesser General Public License is Less protective of the
+users' freedom, it does ensure that the user of a program that is
+linked with the Library has the freedom and the wherewithal to run
+that program using a modified version of the Library.
+
+ The precise terms and conditions for copying, distribution and
+modification follow. Pay close attention to the difference between a
+"work based on the library" and a "work that uses the library". The
+former contains code derived from the library, whereas the latter must
+be combined with the library in order to run.
+
+ GNU LESSER GENERAL PUBLIC LICENSE
+ TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+ 0. This License Agreement applies to any software library or other
+program which contains a notice placed by the copyright holder or
+other authorized party saying it may be distributed under the terms of
+this Lesser General Public License (also called "this License").
+Each licensee is addressed as "you".
+
+ A "library" means a collection of software functions and/or data
+prepared so as to be conveniently linked with application programs
+(which use some of those functions and data) to form executables.
+
+ The "Library", below, refers to any such software library or work
+which has been distributed under these terms. A "work based on the
+Library" means either the Library or any derivative work under
+copyright law: that is to say, a work containing the Library or a
+portion of it, either verbatim or with modifications and/or translated
+straightforwardly into another language. (Hereinafter, translation is
+included without limitation in the term "modification".)
+
+ "Source code" for a work means the preferred form of the work for
+making modifications to it. For a library, complete source code means
+all the source code for all modules it contains, plus any associated
+interface definition files, plus the scripts used to control compilation
+and installation of the library.
+
+ Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope. The act of
+running a program using the Library is not restricted, and output from
+such a program is covered only if its contents constitute a work based
+on the Library (independent of the use of the Library in a tool for
+writing it). Whether that is true depends on what the Library does
+and what the program that uses the Library does.
+
+ 1. You may copy and distribute verbatim copies of the Library's
+complete source code as you receive it, in any medium, provided that
+you conspicuously and appropriately publish on each copy an
+appropriate copyright notice and disclaimer of warranty; keep intact
+all the notices that refer to this License and to the absence of any
+warranty; and distribute a copy of this License along with the
+Library.
+
+ You may charge a fee for the physical act of transferring a copy,
+and you may at your option offer warranty protection in exchange for a
+fee.
+
+ 2. You may modify your copy or copies of the Library or any portion
+of it, thus forming a work based on the Library, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+ a) The modified work must itself be a software library.
+
+ b) You must cause the files modified to carry prominent notices
+ stating that you changed the files and the date of any change.
+
+ c) You must cause the whole of the work to be licensed at no
+ charge to all third parties under the terms of this License.
+
+ d) If a facility in the modified Library refers to a function or a
+ table of data to be supplied by an application program that uses
+ the facility, other than as an argument passed when the facility
+ is invoked, then you must make a good faith effort to ensure that,
+ in the event an application does not supply such function or
+ table, the facility still operates, and performs whatever part of
+ its purpose remains meaningful.
+
+ (For example, a function in a library to compute square roots has
+ a purpose that is entirely well-defined independent of the
+ application. Therefore, Subsection 2d requires that any
+ application-supplied function or table used by this function must
+ be optional: if the application does not supply it, the square
+ root function must still compute square roots.)
+
+These requirements apply to the modified work as a whole. If
+identifiable sections of that work are not derived from the Library,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works. But when you
+distribute the same sections as part of a whole which is a work based
+on the Library, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote
+it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Library.
+
+In addition, mere aggregation of another work not based on the Library
+with the Library (or with a work based on the Library) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+ 3. You may opt to apply the terms of the ordinary GNU General Public
+License instead of this License to a given copy of the Library. To do
+this, you must alter all the notices that refer to this License, so
+that they refer to the ordinary GNU General Public License, version 2,
+instead of to this License. (If a newer version than version 2 of the
+ordinary GNU General Public License has appeared, then you can specify
+that version instead if you wish.) Do not make any other change in
+these notices.
+
+ Once this change is made in a given copy, it is irreversible for
+that copy, so the ordinary GNU General Public License applies to all
+subsequent copies and derivative works made from that copy.
+
+ This option is useful when you wish to copy part of the code of
+the Library into a program that is not a library.
+
+ 4. You may copy and distribute the Library (or a portion or
+derivative of it, under Section 2) in object code or executable form
+under the terms of Sections 1 and 2 above provided that you accompany
+it with the complete corresponding machine-readable source code, which
+must be distributed under the terms of Sections 1 and 2 above on a
+medium customarily used for software interchange.
+
+ If distribution of object code is made by offering access to copy
+from a designated place, then offering equivalent access to copy the
+source code from the same place satisfies the requirement to
+distribute the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+ 5. A program that contains no derivative of any portion of the
+Library, but is designed to work with the Library by being compiled or
+linked with it, is called a "work that uses the Library". Such a
+work, in isolation, is not a derivative work of the Library, and
+therefore falls outside the scope of this License.
+
+ However, linking a "work that uses the Library" with the Library
+creates an executable that is a derivative of the Library (because it
+contains portions of the Library), rather than a "work that uses the
+library". The executable is therefore covered by this License.
+Section 6 states terms for distribution of such executables.
+
+ When a "work that uses the Library" uses material from a header file
+that is part of the Library, the object code for the work may be a
+derivative work of the Library even though the source code is not.
+Whether this is true is especially significant if the work can be
+linked without the Library, or if the work is itself a library. The
+threshold for this to be true is not precisely defined by law.
+
+ If such an object file uses only numerical parameters, data
+structure layouts and accessors, and small macros and small inline
+functions (ten lines or less in length), then the use of the object
+file is unrestricted, regardless of whether it is legally a derivative
+work. (Executables containing this object code plus portions of the
+Library will still fall under Section 6.)
+
+ Otherwise, if the work is a derivative of the Library, you may
+distribute the object code for the work under the terms of Section 6.
+Any executables containing that work also fall under Section 6,
+whether or not they are linked directly with the Library itself.
+
+ 6. As an exception to the Sections above, you may also combine or
+link a "work that uses the Library" with the Library to produce a
+work containing portions of the Library, and distribute that work
+under terms of your choice, provided that the terms permit
+modification of the work for the customer's own use and reverse
+engineering for debugging such modifications.
+
+ You must give prominent notice with each copy of the work that the
+Library is used in it and that the Library and its use are covered by
+this License. You must supply a copy of this License. If the work
+during execution displays copyright notices, you must include the
+copyright notice for the Library among them, as well as a reference
+directing the user to the copy of this License. Also, you must do one
+of these things:
+
+ a) Accompany the work with the complete corresponding
+ machine-readable source code for the Library including whatever
+ changes were used in the work (which must be distributed under
+ Sections 1 and 2 above); and, if the work is an executable linked
+ with the Library, with the complete machine-readable "work that
+ uses the Library", as object code and/or source code, so that the
+ user can modify the Library and then relink to produce a modified
+ executable containing the modified Library. (It is understood
+ that the user who changes the contents of definitions files in the
+ Library will not necessarily be able to recompile the application
+ to use the modified definitions.)
+
+ b) Use a suitable shared library mechanism for linking with the
+ Library. A suitable mechanism is one that (1) uses at run time a
+ copy of the library already present on the user's computer system,
+ rather than copying library functions into the executable, and (2)
+ will operate properly with a modified version of the library, if
+ the user installs one, as long as the modified version is
+ interface-compatible with the version that the work was made with.
+
+ c) Accompany the work with a written offer, valid for at
+ least three years, to give the same user the materials
+ specified in Subsection 6a, above, for a charge no more
+ than the cost of performing this distribution.
+
+ d) If distribution of the work is made by offering access to copy
+ from a designated place, offer equivalent access to copy the above
+ specified materials from the same place.
+
+ e) Verify that the user has already received a copy of these
+ materials or that you have already sent this user a copy.
+
+ For an executable, the required form of the "work that uses the
+Library" must include any data and utility programs needed for
+reproducing the executable from it. However, as a special exception,
+the materials to be distributed need not include anything that is
+normally distributed (in either source or binary form) with the major
+components (compiler, kernel, and so on) of the operating system on
+which the executable runs, unless that component itself accompanies
+the executable.
+
+ It may happen that this requirement contradicts the license
+restrictions of other proprietary libraries that do not normally
+accompany the operating system. Such a contradiction means you cannot
+use both them and the Library together in an executable that you
+distribute.
+
+ 7. You may place library facilities that are a work based on the
+Library side-by-side in a single library together with other library
+facilities not covered by this License, and distribute such a combined
+library, provided that the separate distribution of the work based on
+the Library and of the other library facilities is otherwise
+permitted, and provided that you do these two things:
+
+ a) Accompany the combined library with a copy of the same work
+ based on the Library, uncombined with any other library
+ facilities. This must be distributed under the terms of the
+ Sections above.
+
+ b) Give prominent notice with the combined library of the fact
+ that part of it is a work based on the Library, and explaining
+ where to find the accompanying uncombined form of the same work.
+
+ 8. You may not copy, modify, sublicense, link with, or distribute
+the Library except as expressly provided under this License. Any
+attempt otherwise to copy, modify, sublicense, link with, or
+distribute the Library is void, and will automatically terminate your
+rights under this License. However, parties who have received copies,
+or rights, from you under this License will not have their licenses
+terminated so long as such parties remain in full compliance.
+
+ 9. You are not required to accept this License, since you have not
+signed it. However, nothing else grants you permission to modify or
+distribute the Library or its derivative works. These actions are
+prohibited by law if you do not accept this License. Therefore, by
+modifying or distributing the Library (or any work based on the
+Library), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Library or works based on it.
+
+ 10. Each time you redistribute the Library (or any work based on the
+Library), the recipient automatically receives a license from the
+original licensor to copy, distribute, link with or modify the Library
+subject to these terms and conditions. You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties with
+this License.
+
+ 11. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Library at all. For example, if a patent
+license would not permit royalty-free redistribution of the Library by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Library.
+
+If any portion of this section is held invalid or unenforceable under any
+particular circumstance, the balance of the section is intended to apply,
+and the section as a whole is intended to apply in other circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system which is
+implemented by public license practices. Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+ 12. If the distribution and/or use of the Library is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Library under this License may add
+an explicit geographical distribution limitation excluding those countries,
+so that distribution is permitted only in or among countries not thus
+excluded. In such case, this License incorporates the limitation as if
+written in the body of this License.
+
+ 13. The Free Software Foundation may publish revised and/or new
+versions of the Lesser General Public License from time to time.
+Such new versions will be similar in spirit to the present version,
+but may differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Library
+specifies a version number of this License which applies to it and
+"any later version", you have the option of following the terms and
+conditions either of that version or of any later version published by
+the Free Software Foundation. If the Library does not specify a
+license version number, you may choose any version ever published by
+the Free Software Foundation.
+
+ 14. If you wish to incorporate parts of the Library into other free
+programs whose distribution conditions are incompatible with these,
+write to the author to ask for permission. For software which is
+copyrighted by the Free Software Foundation, write to the Free
+Software Foundation; we sometimes make exceptions for this. Our
+decision will be guided by the two goals of preserving the free status
+of all derivatives of our free software and of promoting the sharing
+and reuse of software generally.
+
+ NO WARRANTY
+
+ 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
+WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
+EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
+OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
+KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
+LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
+THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+ 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
+WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
+AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
+FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
+CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
+LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
+RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
+FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
+SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
+DAMAGES.
+
+ END OF TERMS AND CONDITIONS
diff --git a/lib/data/UNL_Cache_Lite/TODO b/lib/data/UNL_Cache_Lite/TODO
new file mode 100644
index 00000000..e51a0481
--- /dev/null
+++ b/lib/data/UNL_Cache_Lite/TODO
@@ -0,0 +1,46 @@
+
+Patrick O'Lone suggests the following idea which sounds interesting to
+add as an optional mode of Cache_Lite class.
+(still not tested in the Cache_Lite context)
+
+-------------------------------------------------------------------------
+If you use the flags:
+
+ignore_user_abort(true);
+
+$fd = dio_open($szFilename, O_CREATE | O_EXCL | O_TRUNC | O_WRONLY,
+0644);
+if (is_resource($fd)) {
+
+ dio_fcntl($fd, F_SETLKW, array('type' => F_WRLCK));
+ dio_write($fd, $szBuffer);
+ dio_fcntl($fd, F_SETLK, array('type' => F_UNLCK));
+ dio_close($fd);
+
+}
+
+ignore_user_abort(false);
+
+Only the first process will attempt to create a file. Additional
+processes will see that a file already exists (at the system level), and
+will fail. Another thing to note is that the file descriptor must be
+opened using dio_open(), and certain features, like fgets() won't work
+with it. If your just doing a raw write, dio_write() should be just
+fine. The dio_read() function should be used like:
+
+$fd = dio_open($szFilename, O_RDONLY|O_NONBLOCK, 0644);
+if (is_resource($fd)) {
+
+ dio_fcntl($fd, F_SETLKW, array('type' => F_RDLCK));
+ $szBuffer = dio_read($fd, filesize($szFilename));
+ dio_fcntl($fd, F_SETLK, array('type' => F_UNLCK));
+ dio_close($fd);
+
+}
+
+You still use locking to ensure that a write process can finish before
+another attempts to read the file. We also set non-blocking mode in read
+mode so that multiple readers can access the same resource at the same
+time. NOTE: Direct I/O support must be compiled into PHP for these
+features to work (--enable-dio).
+-------------------------------------------------------------------------
diff --git a/lib/docs/UNL_Cache_Lite/docs/examples b/lib/docs/UNL_Cache_Lite/docs/examples
new file mode 100644
index 00000000..ab0a2d19
--- /dev/null
+++ b/lib/docs/UNL_Cache_Lite/docs/examples
@@ -0,0 +1,254 @@
+A few examples of Cache_Lite using :
+------------------------------------
+
+>>> Basic one :
+
+<?php
+
+// Include the package
+require_once('Cache/Lite.php');
+
+// Set a id for this cache
+$id = '123';
+
+// Set a few options
+$options = array(
+ 'cacheDir' => '/tmp/',
+ 'lifeTime' => 3600
+);
+
+// Create a Cache_Lite object
+$Cache_Lite = new Cache_Lite($options);
+
+// Test if thereis a valide cache for this id
+if ($data = $Cache_Lite->get($id)) {
+
+ // Cache hit !
+ // Content is in $data
+ // (...)
+
+} else { // No valid cache found (you have to make the page)
+
+ // Cache miss !
+ // Put in $data datas to put in cache
+ // (...)
+ $Cache_Lite->save($data);
+
+}
+
+?>
+
+
+>>> Usage with blocks
+(You can use Cache_Lite for caching blocks and not the whole page)
+
+<?php
+
+require_once('Cache/Lite.php');
+
+$options = array(
+ 'cacheDir' => '/tmp/',
+ 'lifeTime' => 3600
+);
+
+// Create a Cache_Lite object
+$Cache_Lite = new Cache_Lite($options);
+
+if ($data = $Cache_Lite->get('block1')) {
+ echo($data);
+} else {
+ $data = 'Data of the block 1';
+ $Cache_Lite->save($data);
+}
+
+echo('<br><br>Non cached line !<br><br>');
+
+if ($data = $Cache_Lite->get('block2')) {
+ echo($data);
+} else {
+ $data = 'Data of the block 2';
+ $Cache_Lite->save($data);
+}
+
+?>
+
+
+A few examples of Cache_Lite_Output using :
+-------------------------------------------
+
+>>> Basic one :
+
+<?php
+
+require_once('Cache/Lite/Output.php');
+
+$options = array(
+ 'cacheDir' => '/tmp/',
+ 'lifeTime' => 10
+);
+
+$cache = new Cache_Lite_Output($options);
+
+if (!($cache->start('123'))) {
+ // Cache missed...
+ for($i=0;$i<1000;$i++) { // Making of the page...
+ echo('0123456789');
+ }
+ $cache->end();
+}
+
+?>
+
+>>> Usage with blocks :
+(You can use Cache_Lite_Output for caching blocks and not the whole page)
+
+<?php
+
+require_once('Cache/Lite/Output.php');
+
+$options = array(
+ 'cacheDir' => '/tmp/',
+ 'lifeTime' => 10
+);
+
+$cache = new Cache_Lite_Output($options);
+
+if (!($cache->start('block1'))) {
+ // Cache missed...
+ echo('Data of the block 1 !<br>');
+ $cache->end();
+}
+
+echo('<br><br>Non cached line !<br><br>');
+
+if (!($cache->start('block2'))) {
+ // Cache missed...
+ echo('Data of the block 2 !<br>');
+ $cache->end();
+}
+
+
+A few examples of Cache_Lite_Function using :
+---------------------------------------------
+
+>>> With function :
+
+<?php
+
+require_once('Cache/Lite/Function.php');
+
+$options = array(
+ 'cacheDir' => '/tmp/',
+ 'lifeTime' => 10
+);
+
+$cache = new Cache_Lite_Function($options);
+
+$cache->call('function_to_bench', 12, 45);
+
+function function_to_bench($arg1, $arg2)
+{
+ echo "This is the output of the function function_to_bench($arg1, $arg2) !<br>";
+ return "This is the result of the function function_to_bench($arg1, $arg2) !<br>";
+}
+
+?>
+
+>>> With method :
+
+<?php
+
+require_once('Cache/Lite/Function.php');
+
+$options = array(
+ 'cacheDir' => '/tmp/',
+ 'lifeTime' => 10
+);
+
+$cache = new Cache_Lite_Function($options);
+
+$obj = new bench();
+$obj->test = 666;
+
+$cache->call('obj->method_to_bench', 12, 45);
+
+class bench
+{
+ var $test;
+
+ function method_to_bench($arg1, $arg2)
+ {
+ echo "\$obj->test = $this->test and this is the output of the method \$obj->method_to_bench($arg1, $arg2) !<br>";
+ return "\$obj->test = $this->test and this is the result of the method \$obj->method_to_bench($arg1, $arg2) !<br>";
+ }
+
+}
+
+?>
+
+>>> With static method :
+
+<?php
+
+require_once('Cache/Lite/Function.php');
+
+$options = array(
+ 'cacheDir' => '/tmp/',
+ 'lifeTime' => 10
+);
+
+$cache = new Cache_Lite_Function($options);
+
+$cache->call('bench::static_method_to_bench', 12, 45);
+
+class bench
+{
+ var $test;
+
+ function static_method_to_bench($arg1, $arg2) {
+ echo "This is the output of the function static_method_to_bench($arg1, $arg2) !<br>";
+ return "This is the result of the function static_method_to_bench($arg1, $arg2) !<br>";
+ }
+}
+
+?>
+
+>>> IMPORTANT :
+
+If you try to use Cache_Lite_Function with $this object ($cache->call('this->method',...)
+for example), have a look first at :
+
+http://pear.php.net/bugs/bug.php?id=660
+
+
+A few examples of Cache_Lite_File using :
+-----------------------------------------
+
+<?php
+
+$options = array(
+ 'cacheDir' => '/tmp/',
+ 'masterFile' => '/home/web/config.xml'
+);
+$cache = new Cache_Lite_File($options);
+
+// Set a id for this cache
+$id = '123';
+
+if ($data = $cache->get($id)) {
+
+ // Cache hit !
+ // Content is in $data
+ // (...)
+
+} else { // No valid cache found (you have to make the page)
+
+ // Cache miss !
+ // Put in $data datas to put in cache
+ // (...)
+ $cache->save($data);
+
+}
+
+
+?>
diff --git a/lib/docs/UNL_Cache_Lite/docs/technical b/lib/docs/UNL_Cache_Lite/docs/technical
new file mode 100644
index 00000000..790696c8
--- /dev/null
+++ b/lib/docs/UNL_Cache_Lite/docs/technical
@@ -0,0 +1,28 @@
+Technical choices for Cache_Lite...
+-----------------------------------
+
+To begin, the main goals of Cache_Lite :
+- performances
+- safe use (even on very high traffic or with NFS (file locking doesn't work
+ with NFS))
+- flexibility (can be used by the end user or as a part of a larger script)
+
+
+For speed reasons, it has been decided to focus on the file container (the
+faster one). So, cache is only stored in files. The class is optimized for that.
+If you want to use a different cache container, have a look to PEAR/Cache.
+
+For speed reasons too, the class 'Cache_Lite' has do be independant (so no
+'require_once' at all in 'Cache_Lite.php'). But, a conditional include_once
+is allowed. For example, when an error is detected, the class include dynamicaly
+the PEAR base class 'PEAR.php' to be able to use PEAR::raiseError(). But, in
+most cases, PEAR.php isn't included.
+
+For the second goal (safe use), there is three (optional) mecanisms :
+- File Locking : seems to work fine (but not with distributed file system
+ like NFS...)
+- WriteControl : the cache is read and compared just after being stored
+ (efficient but not perfect)
+- ReadControl : a control key (crc32(), md5() ou strlen()) is embeded is the
+ cache file and compared just after reading (the most efficient
+ but the slowest)
diff --git a/lib/downloads/UNL_Cache_Lite-0.1.0.tgz b/lib/downloads/UNL_Cache_Lite-0.1.0.tgz
new file mode 100644
index 0000000000000000000000000000000000000000..3d4d5c397f49876f7d3a324277c39fe57d0e2061
GIT binary patch
literal 20511
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
literal 0
HcmV?d00001
diff --git a/lib/php/UNL/Cache/Lite.php b/lib/php/UNL/Cache/Lite.php
new file mode 100644
index 00000000..4c3240a2
--- /dev/null
+++ b/lib/php/UNL/Cache/Lite.php
@@ -0,0 +1,844 @@
+<?php
+
+/**
+* Fast, light and safe Cache Class
+*
+* UNL_Cache_Lite is a fast, light and safe cache system. It's optimized
+* for file containers. It is fast and safe (because it uses file
+* locking and/or anti-corruption tests).
+*
+* There are some examples in the 'docs/examples' file
+* Technical choices are described in the 'docs/technical' file
+*
+* Memory Caching is from an original idea of
+* Mike BENOIT <ipso@snappymail.ca>
+*
+* Nota : A chinese documentation (thanks to RainX <china_1982@163.com>) is
+* available at :
+* http://rainx.phpmore.com/manual/UNL_Cache_Lite.html
+*
+* @package UNL_Cache_Lite
+* @category Caching
+* @version $Id: Lite.php 283629 2009-07-07 05:34:37Z tacker $
+* @author Fabien MARTY <fab@php.net>
+*/
+
+define('UNL_CACHE_LITE_ERROR_RETURN', 1);
+define('UNL_CACHE_LITE_ERROR_DIE', 8);
+
+class UNL_Cache_Lite
+{
+
+ // --- Private properties ---
+
+ /**
+ * Directory where to put the cache files
+ * (make sure to add a trailing slash)
+ *
+ * @var string $_cacheDir
+ */
+ protected $_cacheDir = '/tmp/';
+
+ /**
+ * Enable / disable caching
+ *
+ * (can be very usefull for the debug of cached scripts)
+ *
+ * @var boolean $_caching
+ */
+ protected $_caching = true;
+
+ /**
+ * Cache lifetime (in seconds)
+ *
+ * If null, the cache is valid forever.
+ *
+ * @var int $_lifeTime
+ */
+ protected $_lifeTime = 3600;
+
+ /**
+ * Enable / disable fileLocking
+ *
+ * (can avoid cache corruption under bad circumstances)
+ *
+ * @var boolean $_fileLocking
+ */
+ protected $_fileLocking = true;
+
+ /**
+ * Timestamp of the last valid cache
+ *
+ * @var int $_refreshTime
+ */
+ protected $_refreshTime;
+
+ /**
+ * File name (with path)
+ *
+ * @var string $_file
+ */
+ protected $_file;
+
+ /**
+ * File name (without path)
+ *
+ * @var string $_fileName
+ */
+ protected $_fileName;
+
+ /**
+ * Enable / disable write control (the cache is read just after writing to detect corrupt entries)
+ *
+ * Enable write control will lightly slow the cache writing but not the cache reading
+ * Write control can detect some corrupt cache files but maybe it's not a perfect control
+ *
+ * @var boolean $_writeControl
+ */
+ protected $_writeControl = true;
+
+ /**
+ * Enable / disable read control
+ *
+ * If enabled, a control key is embeded in cache file and this key is compared with the one
+ * calculated after the reading.
+ *
+ * @var boolean $_writeControl
+ */
+ protected $_readControl = true;
+
+ /**
+ * Type of read control (only if read control is enabled)
+ *
+ * Available values are :
+ * 'md5' for a md5 hash control (best but slowest)
+ * 'crc32' for a crc32 hash control (lightly less safe but faster, better choice)
+ * 'strlen' for a length only test (fastest)
+ *
+ * @var boolean $_readControlType
+ */
+ protected $_readControlType = 'crc32';
+
+ /**
+ * Pear error mode (when raiseError is called)
+ *
+ * (see PEAR doc)
+ *
+ * @see setToDebug()
+ * @var int $_pearErrorMode
+ */
+ protected $_errorMode = UNL_CACHE_LITE_ERROR_RETURN;
+
+ /**
+ * Current cache id
+ *
+ * @var string $_id
+ */
+ protected $_id;
+
+ /**
+ * Current cache group
+ *
+ * @var string $_group
+ */
+ protected $_group;
+
+ /**
+ * Enable / Disable "Memory Caching"
+ *
+ * NB : There is no lifetime for memory caching !
+ *
+ * @var boolean $_memoryCaching
+ */
+ protected $_memoryCaching = false;
+
+ /**
+ * Enable / Disable "Only Memory Caching"
+ * (be carefull, memory caching is "beta quality")
+ *
+ * @var boolean $_onlyMemoryCaching
+ */
+ protected $_onlyMemoryCaching = false;
+
+ /**
+ * Memory caching array
+ *
+ * @var array $_memoryCachingArray
+ */
+ protected $_memoryCachingArray = array();
+
+ /**
+ * Memory caching counter
+ *
+ * @var int $memoryCachingCounter
+ */
+ protected $_memoryCachingCounter = 0;
+
+ /**
+ * Memory caching limit
+ *
+ * @var int $memoryCachingLimit
+ */
+ protected $_memoryCachingLimit = 1000;
+
+ /**
+ * File Name protection
+ *
+ * if set to true, you can use any cache id or group name
+ * if set to false, it can be faster but cache ids and group names
+ * will be used directly in cache file names so be carefull with
+ * special characters...
+ *
+ * @var boolean $fileNameProtection
+ */
+ protected $_fileNameProtection = true;
+
+ /**
+ * Enable / disable automatic serialization
+ *
+ * it can be used to save directly datas which aren't strings
+ * (but it's slower)
+ *
+ * @var boolean $_serialize
+ */
+ protected $_automaticSerialization = false;
+
+ /**
+ * Disable / Tune the automatic cleaning process
+ *
+ * The automatic cleaning process destroy too old (for the given life time)
+ * cache files when a new cache file is written.
+ * 0 => no automatic cache cleaning
+ * 1 => systematic cache cleaning
+ * x (integer) > 1 => automatic cleaning randomly 1 times on x cache write
+ *
+ * @var int $_automaticCleaning
+ */
+ protected $_automaticCleaningFactor = 0;
+
+ /**
+ * Nested directory level
+ *
+ * Set the hashed directory structure level. 0 means "no hashed directory
+ * structure", 1 means "one level of directory", 2 means "two levels"...
+ * This option can speed up UNL_Cache_Lite only when you have many thousands of
+ * cache file. Only specific benchs can help you to choose the perfect value
+ * for you. Maybe, 1 or 2 is a good start.
+ *
+ * @var int $_hashedDirectoryLevel
+ */
+ protected $_hashedDirectoryLevel = 0;
+
+ /**
+ * Umask for hashed directory structure
+ *
+ * @var int $_hashedDirectoryUmask
+ */
+ protected $_hashedDirectoryUmask = 0700;
+
+ /**
+ * API break for error handling in UNL_Cache_Lite_ERROR_RETURN mode
+ *
+ * In UNL_Cache_Lite_ERROR_RETURN mode, error handling was not good because
+ * for example save() method always returned a boolean (a PEAR_Error object
+ * would be better in UNL_Cache_Lite_ERROR_RETURN mode). To correct this without
+ * breaking the API, this option (false by default) can change this handling.
+ *
+ * @var boolean
+ */
+ protected $_errorHandlingAPIBreak = false;
+
+ // --- Public methods ---
+
+ /**
+ * Constructor
+ *
+ * $options is an assoc. Available options are :
+ * $options = array(
+ * 'cacheDir' => directory where to put the cache files (string),
+ * 'caching' => enable / disable caching (boolean),
+ * 'lifeTime' => cache lifetime in seconds (int),
+ * 'fileLocking' => enable / disable fileLocking (boolean),
+ * 'writeControl' => enable / disable write control (boolean),
+ * 'readControl' => enable / disable read control (boolean),
+ * 'readControlType' => type of read control 'crc32', 'md5', 'strlen' (string),
+ * 'pearErrorMode' => pear error mode (when raiseError is called) (cf PEAR doc) (int),
+ * 'memoryCaching' => enable / disable memory caching (boolean),
+ * 'onlyMemoryCaching' => enable / disable only memory caching (boolean),
+ * 'memoryCachingLimit' => max nbr of records to store into memory caching (int),
+ * 'fileNameProtection' => enable / disable automatic file name protection (boolean),
+ * 'automaticSerialization' => enable / disable automatic serialization (boolean),
+ * 'automaticCleaningFactor' => distable / tune automatic cleaning process (int),
+ * 'hashedDirectoryLevel' => level of the hashed directory system (int),
+ * 'hashedDirectoryUmask' => umask for hashed directory structure (int),
+ * 'errorHandlingAPIBreak' => API break for better error handling ? (boolean)
+ * );
+ *
+ * @param array $options options
+ * @access public
+ */
+ function __construct($options = array(NULL))
+ {
+ $this->setOptions($options);
+ }
+
+ /**
+ * Allows you to set an array of options.
+ *
+ * @param array $options associative array of options
+ */
+ function setOptions($options = array(NULL))
+ {
+ foreach($options as $key => $value) {
+ $this->setOption($key, $value);
+ }
+ }
+
+ /**
+ * Generic way to set a UNL_Cache_Lite option
+ *
+ * see UNL_Cache_Lite constructor for available options
+ *
+ * @var string $name name of the option
+ * @var mixed $value value of the option
+ * @access public
+ */
+ function setOption($name, $value)
+ {
+ $availableOptions = array('errorHandlingAPIBreak', 'hashedDirectoryUmask', 'hashedDirectoryLevel', 'automaticCleaningFactor', 'automaticSerialization', 'fileNameProtection', 'memoryCaching', 'onlyMemoryCaching', 'memoryCachingLimit', 'cacheDir', 'caching', 'lifeTime', 'fileLocking', 'writeControl', 'readControl', 'readControlType', 'pearErrorMode');
+ if (in_array($name, $availableOptions)) {
+ $property = '_'.$name;
+ $this->$property = $value;
+ }
+ }
+
+ /**
+ * Test if a cache is available and (if yes) return it
+ *
+ * @param string $id cache id
+ * @param string $group name of the cache group
+ * @param boolean $doNotTestCacheValidity if set to true, the cache validity won't be tested
+ * @return string data of the cache (else : false)
+ * @access public
+ */
+ function get($id, $group = 'default', $doNotTestCacheValidity = false)
+ {
+ $this->_id = $id;
+ $this->_group = $group;
+ $data = false;
+ if ($this->_caching) {
+ $this->_setRefreshTime();
+ $this->_setFileName($id, $group);
+ clearstatcache();
+ if ($this->_memoryCaching) {
+ if (isset($this->_memoryCachingArray[$this->_file])) {
+ if ($this->_automaticSerialization) {
+ return unserialize($this->_memoryCachingArray[$this->_file]);
+ }
+ return $this->_memoryCachingArray[$this->_file];
+ }
+ if ($this->_onlyMemoryCaching) {
+ return false;
+ }
+ }
+ if (($doNotTestCacheValidity) || (is_null($this->_refreshTime))) {
+ if (file_exists($this->_file)) {
+ $data = $this->_read();
+ }
+ } else {
+ if ((file_exists($this->_file)) && (@filemtime($this->_file) > $this->_refreshTime)) {
+ $data = $this->_read();
+ }
+ }
+ if (($data) and ($this->_memoryCaching)) {
+ $this->_memoryCacheAdd($data);
+ }
+ if (($this->_automaticSerialization) and (is_string($data))) {
+ $data = unserialize($data);
+ }
+ return $data;
+ }
+ return false;
+ }
+
+ /**
+ * Save some data in a cache file
+ *
+ * @param string $data data to put in cache (can be another type than strings if automaticSerialization is on)
+ * @param string $id cache id
+ * @param string $group name of the cache group
+ * @return boolean true if no problem (else : false or a PEAR_Error object)
+ * @access public
+ */
+ function save($data, $id = NULL, $group = 'default')
+ {
+ if ($this->_caching) {
+ if ($this->_automaticSerialization) {
+ $data = serialize($data);
+ }
+ if (isset($id)) {
+ $this->_setFileName($id, $group);
+ }
+ if ($this->_memoryCaching) {
+ $this->_memoryCacheAdd($data);
+ if ($this->_onlyMemoryCaching) {
+ return true;
+ }
+ }
+ if ($this->_automaticCleaningFactor>0 && ($this->_automaticCleaningFactor==1 || mt_rand(1, $this->_automaticCleaningFactor)==1)) {
+ $this->clean(false, 'old');
+ }
+ if ($this->_writeControl) {
+ $res = $this->_writeAndControl($data);
+ if (is_bool($res)) {
+ if ($res) {
+ return true;
+ }
+ // if $res if false, we need to invalidate the cache
+ @touch($this->_file, time() - 2*abs($this->_lifeTime));
+ return false;
+ }
+ } else {
+ $res = $this->_write($data);
+ }
+ if (is_object($res)) {
+ // $res is a PEAR_Error object
+ if (!($this->_errorHandlingAPIBreak)) {
+ return false; // we return false (old API)
+ }
+ }
+ return $res;
+ }
+ return false;
+ }
+
+ /**
+ * Remove a cache file
+ *
+ * @param string $id cache id
+ * @param string $group name of the cache group
+ * @param boolean $checkbeforeunlink check if file exists before removing it
+ * @return boolean true if no problem
+ * @access public
+ */
+ function remove($id, $group = 'default', $checkbeforeunlink = false)
+ {
+ $this->_setFileName($id, $group);
+ if ($this->_memoryCaching) {
+ if (isset($this->_memoryCachingArray[$this->_file])) {
+ unset($this->_memoryCachingArray[$this->_file]);
+ $this->_memoryCachingCounter = $this->_memoryCachingCounter - 1;
+ }
+ if ($this->_onlyMemoryCaching) {
+ return true;
+ }
+ }
+ if ( $checkbeforeunlink ) {
+ if (!file_exists($this->_file)) return true;
+ }
+ return $this->_unlink($this->_file);
+ }
+
+ /**
+ * Clean the cache
+ *
+ * if no group is specified all cache files will be destroyed
+ * else only cache files of the specified group will be destroyed
+ *
+ * @param string $group name of the cache group
+ * @param string $mode flush cache mode : 'old', 'ingroup', 'notingroup',
+ * 'callback_myFunction'
+ * @return boolean true if no problem
+ * @access public
+ */
+ function clean($group = false, $mode = 'ingroup')
+ {
+ return $this->_cleanDir($this->_cacheDir, $group, $mode);
+ }
+
+ /**
+ * Set to debug mode
+ *
+ * When an error is found, the script will stop and the message will be displayed
+ * (in debug mode only).
+ *
+ * @access public
+ */
+ function setToDebug()
+ {
+ $this->setOption('pearErrorMode', UNL_CACHE_LITE_ERROR_DIE);
+ }
+
+ /**
+ * Set a new life time
+ *
+ * @param int $newLifeTime new life time (in seconds)
+ * @access public
+ */
+ function setLifeTime($newLifeTime)
+ {
+ $this->_lifeTime = $newLifeTime;
+ $this->_setRefreshTime();
+ }
+
+ /**
+ * Save the state of the caching memory array into a cache file cache
+ *
+ * @param string $id cache id
+ * @param string $group name of the cache group
+ * @access public
+ */
+ function saveMemoryCachingState($id, $group = 'default')
+ {
+ if ($this->_caching) {
+ $array = array(
+ 'counter' => $this->_memoryCachingCounter,
+ 'array' => $this->_memoryCachingArray
+ );
+ $data = serialize($array);
+ $this->save($data, $id, $group);
+ }
+ }
+
+ /**
+ * Load the state of the caching memory array from a given cache file cache
+ *
+ * @param string $id cache id
+ * @param string $group name of the cache group
+ * @param boolean $doNotTestCacheValidity if set to true, the cache validity won't be tested
+ * @access public
+ */
+ function getMemoryCachingState($id, $group = 'default', $doNotTestCacheValidity = false)
+ {
+ if ($this->_caching) {
+ if ($data = $this->get($id, $group, $doNotTestCacheValidity)) {
+ $array = unserialize($data);
+ $this->_memoryCachingCounter = $array['counter'];
+ $this->_memoryCachingArray = $array['array'];
+ }
+ }
+ }
+
+ /**
+ * Return the cache last modification time
+ *
+ * BE CAREFUL : THIS METHOD IS FOR HACKING ONLY !
+ *
+ * @return int last modification time
+ */
+ function lastModified()
+ {
+ return @filemtime($this->_file);
+ }
+
+ /**
+ * Trigger a PEAR error
+ *
+ * To improve performances, the PEAR.php file is included dynamically.
+ * The file is so included only when an error is triggered. So, in most
+ * cases, the file isn't included and perfs are much better.
+ *
+ * @param string $msg error message
+ * @param int $code error code
+ * @access public
+ */
+ function raiseError($msg, $code)
+ {
+ throw new Exception($msg, $code);
+ }
+
+ /**
+ * Extend the life of a valid cache file
+ *
+ * see http://pear.php.net/bugs/bug.php?id=6681
+ *
+ * @access public
+ */
+ function extendLife()
+ {
+ @touch($this->_file);
+ }
+
+ // --- Private methods ---
+
+ /**
+ * Compute & set the refresh time
+ *
+ * @access private
+ */
+ protected function _setRefreshTime()
+ {
+ if (is_null($this->_lifeTime)) {
+ $this->_refreshTime = null;
+ } else {
+ $this->_refreshTime = time() - $this->_lifeTime;
+ }
+ }
+
+ /**
+ * Remove a file
+ *
+ * @param string $file complete file path and name
+ * @return boolean true if no problem
+ * @access private
+ */
+ protected function _unlink($file)
+ {
+ if (file_exists($file) && !@unlink($file)) {
+ return $this->raiseError('UNL_Cache_Lite : Unable to remove cache '.$file, -3);
+ }
+ return true;
+ }
+
+ /**
+ * Recursive function for cleaning cache file in the given directory
+ *
+ * @param string $dir directory complete path (with a trailing slash)
+ * @param string $group name of the cache group
+ * @param string $mode flush cache mode : 'old', 'ingroup', 'notingroup',
+ 'callback_myFunction'
+ * @return boolean true if no problem
+ * @access private
+ */
+ protected function _cleanDir($dir, $group = false, $mode = 'ingroup')
+ {
+ if ($this->_fileNameProtection) {
+ $motif = ($group) ? 'unlcache_'.md5($group).'_' : 'unlcache_';
+ } else {
+ $motif = ($group) ? 'unlcache_'.$group.'_' : 'unlcache_';
+ }
+ if ($this->_memoryCaching) {
+ foreach($this->_memoryCachingArray as $key => $v) {
+ if (strpos($key, $motif) !== false) {
+ unset($this->_memoryCachingArray[$key]);
+ $this->_memoryCachingCounter = $this->_memoryCachingCounter - 1;
+ }
+ }
+ if ($this->_onlyMemoryCaching) {
+ return true;
+ }
+ }
+ if (!($dh = opendir($dir))) {
+ return $this->raiseError('UNL_Cache_Lite : Unable to open cache directory !', -4);
+ }
+ $result = true;
+ while ($file = readdir($dh)) {
+ if (($file != '.') && ($file != '..')) {
+ if (substr($file, 0, 6)=='unlcache_') {
+ $file2 = $dir . $file;
+ if (is_file($file2)) {
+ switch (substr($mode, 0, 9)) {
+ case 'old':
+ // files older than lifeTime get deleted from cache
+ if (!is_null($this->_lifeTime)) {
+ if ((time() - @filemtime($file2)) > $this->_lifeTime) {
+ $result = ($result and ($this->_unlink($file2)));
+ }
+ }
+ break;
+ case 'notingrou':
+ if (strpos($file2, $motif) === false) {
+ $result = ($result and ($this->_unlink($file2)));
+ }
+ break;
+ case 'callback_':
+ $func = substr($mode, 9, strlen($mode) - 9);
+ if ($func($file2, $group)) {
+ $result = ($result and ($this->_unlink($file2)));
+ }
+ break;
+ case 'ingroup':
+ default:
+ if (strpos($file2, $motif) !== false) {
+ $result = ($result and ($this->_unlink($file2)));
+ }
+ break;
+ }
+ }
+ if ((is_dir($file2)) and ($this->_hashedDirectoryLevel>0)) {
+ $result = ($result and ($this->_cleanDir($file2 . '/', $group, $mode)));
+ }
+ }
+ }
+ }
+ return $result;
+ }
+
+ /**
+ * Add some date in the memory caching array
+ *
+ * @param string $data data to cache
+ * @access private
+ */
+ protected function _memoryCacheAdd($data)
+ {
+ $this->_memoryCachingArray[$this->_file] = $data;
+ if ($this->_memoryCachingCounter >= $this->_memoryCachingLimit) {
+ list($key, ) = each($this->_memoryCachingArray);
+ unset($this->_memoryCachingArray[$key]);
+ } else {
+ $this->_memoryCachingCounter = $this->_memoryCachingCounter + 1;
+ }
+ }
+
+ /**
+ * Make a file name (with path)
+ *
+ * @param string $id cache id
+ * @param string $group name of the group
+ * @access private
+ */
+ protected function _setFileName($id, $group)
+ {
+
+ if ($this->_fileNameProtection) {
+ $suffix = 'unlcache_'.md5($group).'_'.md5($id);
+ } else {
+ $suffix = 'unlcache_'.$group.'_'.$id;
+ }
+ $root = $this->_cacheDir;
+ if ($this->_hashedDirectoryLevel>0) {
+ $hash = md5($suffix);
+ for ($i=0 ; $i<$this->_hashedDirectoryLevel ; $i++) {
+ $root = $root . 'unlcache_' . substr($hash, 0, $i + 1) . '/';
+ }
+ }
+ $this->_fileName = $suffix;
+ $this->_file = $root.$suffix;
+ }
+
+ /**
+ * Read the cache file and return the content
+ *
+ * @return string content of the cache file (else : false or a PEAR_Error object)
+ * @access private
+ */
+ protected function _read()
+ {
+ $fp = @fopen($this->_file, "rb");
+ if ($this->_fileLocking) @flock($fp, LOCK_SH);
+ if ($fp) {
+ clearstatcache();
+ $length = @filesize($this->_file);
+ $mqr = get_magic_quotes_runtime();
+ if ($mqr) {
+ set_magic_quotes_runtime(0);
+ }
+ if ($this->_readControl) {
+ $hashControl = @fread($fp, 32);
+ $length = $length - 32;
+ }
+ if ($length) {
+ $data = @fread($fp, $length);
+ } else {
+ $data = '';
+ }
+ if ($mqr) {
+ set_magic_quotes_runtime($mqr);
+ }
+ if ($this->_fileLocking) @flock($fp, LOCK_UN);
+ @fclose($fp);
+ if ($this->_readControl) {
+ $hashData = $this->_hash($data, $this->_readControlType);
+ if ($hashData != $hashControl) {
+ if (!(is_null($this->_lifeTime))) {
+ @touch($this->_file, time() - 2*abs($this->_lifeTime));
+ } else {
+ @unlink($this->_file);
+ }
+ return false;
+ }
+ }
+ return $data;
+ }
+ return $this->raiseError('UNL_Cache_Lite : Unable to read cache !', -2);
+ }
+
+ /**
+ * Write the given data in the cache file
+ *
+ * @param string $data data to put in cache
+ * @return boolean true if ok (a PEAR_Error object else)
+ * @access private
+ */
+ protected function _write($data)
+ {
+ if ($this->_hashedDirectoryLevel > 0) {
+ $hash = md5($this->_fileName);
+ $root = $this->_cacheDir;
+ for ($i=0 ; $i<$this->_hashedDirectoryLevel ; $i++) {
+ $root = $root . 'unlcache_' . substr($hash, 0, $i + 1) . '/';
+ if (!(@is_dir($root))) {
+ @mkdir($root, $this->_hashedDirectoryUmask);
+ }
+ }
+ }
+ $fp = @fopen($this->_file, "wb");
+ if ($fp) {
+ if ($this->_fileLocking) @flock($fp, LOCK_EX);
+ if ($this->_readControl) {
+ @fwrite($fp, $this->_hash($data, $this->_readControlType), 32);
+ }
+ $mqr = get_magic_quotes_runtime();
+ if ($mqr) {
+ set_magic_quotes_runtime(0);
+ }
+ @fwrite($fp, $data);
+ if ($mqr) {
+ set_magic_quotes_runtime($mqr);
+ }
+ if ($this->_fileLocking) @flock($fp, LOCK_UN);
+ @fclose($fp);
+ return true;
+ }
+ return $this->raiseError('UNL_Cache_Lite : Unable to write cache file : '.$this->_file, -1);
+ }
+
+ /**
+ * Write the given data in the cache file and control it just after to avoir corrupted cache entries
+ *
+ * @param string $data data to put in cache
+ * @return boolean true if the test is ok (else : false or a PEAR_Error object)
+ * @access private
+ */
+ protected function _writeAndControl($data)
+ {
+ $result = $this->_write($data);
+ if (is_object($result)) {
+ return $result; # We return the PEAR_Error object
+ }
+ $dataRead = $this->_read();
+ if (is_object($dataRead)) {
+ return $dataRead; # We return the PEAR_Error object
+ }
+ if ((is_bool($dataRead)) && (!$dataRead)) {
+ return false;
+ }
+ return ($dataRead==$data);
+ }
+
+ /**
+ * Make a control key with the string containing datas
+ *
+ * @param string $data data
+ * @param string $controlType type of control 'md5', 'crc32' or 'strlen'
+ * @return string control key
+ * @access private
+ */
+ protected function _hash($data, $controlType)
+ {
+ switch ($controlType) {
+ case 'md5':
+ return md5($data);
+ case 'crc32':
+ return sprintf('% 32d', crc32($data));
+ case 'strlen':
+ return sprintf('% 32d', strlen($data));
+ default:
+ return $this->raiseError('Unknown controlType ! (available values are only \'md5\', \'crc32\', \'strlen\')', -5);
+ }
+ }
+
+}
+
+?>
diff --git a/lib/php/UNL/Cache/Lite/File.php b/lib/php/UNL/Cache/Lite/File.php
new file mode 100644
index 00000000..3cbdc19f
--- /dev/null
+++ b/lib/php/UNL/Cache/Lite/File.php
@@ -0,0 +1,91 @@
+<?php
+
+/**
+* This class extends UNL_Cache_Lite and offers a cache system driven by a master file
+*
+* With this class, cache validity is only dependent of a given file. Cache files
+* are valid only if they are older than the master file. It's a perfect way for
+* caching templates results (if the template file is newer than the cache, cache
+* must be rebuild...) or for config classes...
+* There are some examples in the 'docs/examples' file
+* Technical choices are described in the 'docs/technical' file
+*
+* @package UNL_Cache_Lite
+* @version $Id: File.php 276823 2009-03-07 12:55:39Z tacker $
+* @author Fabien MARTY <fab@php.net>
+*/
+
+class UNL_Cache_Lite_File extends UNL_Cache_Lite
+{
+
+ // --- Private properties ---
+
+ /**
+ * Complete path of the file used for controlling the cache lifetime
+ *
+ * @var string $_masterFile
+ */
+ protected $_masterFile = '';
+
+ /**
+ * Masterfile mtime
+ *
+ * @var int $_masterFile_mtime
+ */
+ protected $_masterFile_mtime = 0;
+
+ // --- Public methods ----
+
+ /**
+ * Constructor
+ *
+ * $options is an assoc. To have a look at availables options,
+ * see the constructor of the UNL_Cache_Lite class in 'UNL_Cache_Lite.php'
+ *
+ * Comparing to UNL_Cache_Lite constructor, there is another option :
+ * $options = array(
+ * (...) see UNL_Cache_Lite constructor
+ * 'masterFile' => complete path of the file used for controlling the cache lifetime(string)
+ * );
+ *
+ * @param array $options options
+ * @access public
+ */
+ function __construct($options = array(NULL))
+ {
+ $options['lifetime'] = 0;
+ $this->setOptions($options);
+ if (isset($options['masterFile'])) {
+ $this->_masterFile = $options['masterFile'];
+ } else {
+ return $this->raiseError('UNL_Cache_Lite_File : masterFile option must be set !');
+ }
+ if (!($this->_masterFile_mtime = @filemtime($this->_masterFile))) {
+ return $this->raiseError('UNL_Cache_Lite_File : Unable to read masterFile : '.$this->_masterFile, -3);
+ }
+ }
+
+ /**
+ * Test if a cache is available and (if yes) return it
+ *
+ * @param string $id cache id
+ * @param string $group name of the cache group
+ * @param boolean $doNotTestCacheValidity if set to true, the cache validity won't be tested
+ * @return string data of the cache (else : false)
+ * @access public
+ */
+ function get($id, $group = 'default', $doNotTestCacheValidity = false)
+ {
+ if ($data = parent::get($id, $group, true)) {
+ if ($filemtime = $this->lastModified()) {
+ if ($filemtime > $this->_masterFile_mtime) {
+ return $data;
+ }
+ }
+ }
+ return false;
+ }
+
+}
+
+?>
diff --git a/lib/php/UNL/Cache/Lite/Function.php b/lib/php/UNL/Cache/Lite/Function.php
new file mode 100644
index 00000000..a8a268fa
--- /dev/null
+++ b/lib/php/UNL/Cache/Lite/Function.php
@@ -0,0 +1,209 @@
+<?php
+
+/**
+* This class extends UNL_Cache_Lite and can be used to cache the result and output of functions/methods
+*
+* This class is completly inspired from Sebastian Bergmann's
+* PEAR/Cache_Function class. This is only an adaptation to
+* UNL_Cache_Lite
+*
+* There are some examples in the 'docs/examples' file
+* Technical choices are described in the 'docs/technical' file
+*
+* @package UNL_Cache_Lite
+* @version $Id: Function.php 225008 2006-12-14 12:59:43Z cweiske $
+* @author Sebastian BERGMANN <sb@sebastian-bergmann.de>
+* @author Fabien MARTY <fab@php.net>
+*/
+
+class UNL_Cache_Lite_Function extends UNL_Cache_Lite
+{
+
+ // --- Private properties ---
+
+ /**
+ * Default cache group for function caching
+ *
+ * @var string $_defaultGroup
+ */
+ protected $_defaultGroup = 'UNL_Cache_Lite_Function';
+
+ /**
+ * Don't cache the method call when its output contains the string "NOCACHE"
+ *
+ * if set to true, the output of the method will never be displayed (because the output is used
+ * to control the cache)
+ *
+ * @var boolean $_dontCacheWhenTheOutputContainsNOCACHE
+ */
+ protected $_dontCacheWhenTheOutputContainsNOCACHE = false;
+
+ /**
+ * Don't cache the method call when its result is false
+ *
+ * @var boolean $_dontCacheWhenTheResultIsFalse
+ */
+ protected $_dontCacheWhenTheResultIsFalse = false;
+
+ /**
+ * Don't cache the method call when its result is null
+ *
+ * @var boolean $_dontCacheWhenTheResultIsNull
+ */
+ protected $_dontCacheWhenTheResultIsNull = false;
+
+ /**
+ * Debug the UNL_Cache_Lite_Function caching process
+ *
+ * @var boolean $_debugCacheLiteFunction
+ */
+ protected $_debugCacheLiteFunction = false;
+
+ // --- Public methods ----
+
+ /**
+ * Constructor
+ *
+ * $options is an assoc. To have a look at availables options,
+ * see the constructor of the UNL_Cache_Lite class in 'UNL_Cache_Lite.php'
+ *
+ * Comparing to UNL_Cache_Lite constructor, there is another option :
+ * $options = array(
+ * (...) see UNL_Cache_Lite constructor
+ * 'debugCacheLiteFunction' => (bool) debug the caching process,
+ * 'defaultGroup' => default cache group for function caching (string),
+ * 'dontCacheWhenTheOutputContainsNOCACHE' => (bool) don't cache when the function output contains "NOCACHE",
+ * 'dontCacheWhenTheResultIsFalse' => (bool) don't cache when the function result is false,
+ * 'dontCacheWhenTheResultIsNull' => (bool don't cache when the function result is null
+ * );
+ *
+ * @param array $options options
+ * @access public
+ */
+ function __construct($options = array(NULL))
+ {
+ $availableOptions = array('debugCacheLiteFunction', 'defaultGroup', 'dontCacheWhenTheOutputContainsNOCACHE', 'dontCacheWhenTheResultIsFalse', 'dontCacheWhenTheResultIsNull');
+ while (list($name, $value) = each($options)) {
+ if (in_array($name, $availableOptions)) {
+ $property = '_'.$name;
+ $this->$property = $value;
+ }
+ }
+ reset($options);
+ $this->setOptions($options);
+ }
+
+ /**
+ * Calls a cacheable function or method (or not if there is already a cache for it)
+ *
+ * Arguments of this method are read with func_get_args. So it doesn't appear
+ * in the function definition. Synopsis :
+ * call('functionName', $arg1, $arg2, ...)
+ * (arg1, arg2... are arguments of 'functionName')
+ *
+ * @return mixed result of the function/method
+ * @access public
+ */
+ function call()
+ {
+ $arguments = func_get_args();
+ $id = $this->_makeId($arguments);
+ $data = $this->get($id, $this->_defaultGroup);
+ if ($data !== false) {
+ if ($this->_debugCacheLiteFunction) {
+ echo "Cache hit !\n";
+ }
+ $array = unserialize($data);
+ $output = $array['output'];
+ $result = $array['result'];
+ } else {
+ if ($this->_debugCacheLiteFunction) {
+ echo "Cache missed !\n";
+ }
+ ob_start();
+ ob_implicit_flush(false);
+ $target = array_shift($arguments);
+ if (is_array($target)) {
+ // in this case, $target is for example array($obj, 'method')
+ $object = $target[0];
+ $method = $target[1];
+ $result = call_user_func_array(array(&$object, $method), $arguments);
+ } else {
+ if (strstr($target, '::')) { // classname::staticMethod
+ list($class, $method) = explode('::', $target);
+ $result = call_user_func_array(array($class, $method), $arguments);
+ } else if (strstr($target, '->')) { // object->method
+ // use a stupid name ($objet_123456789 because) of problems where the object
+ // name is the same as this var name
+ list($object_123456789, $method) = explode('->', $target);
+ global $$object_123456789;
+ $result = call_user_func_array(array($$object_123456789, $method), $arguments);
+ } else { // function
+ $result = call_user_func_array($target, $arguments);
+ }
+ }
+ $output = ob_get_contents();
+ ob_end_clean();
+ if ($this->_dontCacheWhenTheResultIsFalse) {
+ if ((is_bool($result)) && (!($result))) {
+ echo($output);
+ return $result;
+ }
+ }
+ if ($this->_dontCacheWhenTheResultIsNull) {
+ if (is_null($result)) {
+ echo($output);
+ return $result;
+ }
+ }
+ if ($this->_dontCacheWhenTheOutputContainsNOCACHE) {
+ if (strpos($output, 'NOCACHE') > -1) {
+ return $result;
+ }
+ }
+ $array['output'] = $output;
+ $array['result'] = $result;
+ $this->save(serialize($array), $id, $this->_defaultGroup);
+ }
+ echo($output);
+ return $result;
+ }
+
+ /**
+ * Drop a cache file
+ *
+ * Arguments of this method are read with func_get_args. So it doesn't appear
+ * in the function definition. Synopsis :
+ * remove('functionName', $arg1, $arg2, ...)
+ * (arg1, arg2... are arguments of 'functionName')
+ *
+ * @return boolean true if no problem
+ * @access public
+ */
+ function drop()
+ {
+ $id = $this->_makeId(func_get_args());
+ return $this->remove($id, $this->_defaultGroup);
+ }
+
+ /**
+ * Make an id for the cache
+ *
+ * @var array result of func_get_args for the call() or the remove() method
+ * @return string id
+ * @access private
+ */
+ function _makeId($arguments)
+ {
+ $id = serialize($arguments); // Generate a cache id
+ if (!$this->_fileNameProtection) {
+ $id = md5($id);
+ // if fileNameProtection is set to false, then the id has to be hashed
+ // because it's a very bad file name in most cases
+ }
+ return $id;
+ }
+
+}
+
+?>
diff --git a/lib/php/UNL/Cache/Lite/NestedOutput.php b/lib/php/UNL/Cache/Lite/NestedOutput.php
new file mode 100644
index 00000000..06d10f5d
--- /dev/null
+++ b/lib/php/UNL/Cache/Lite/NestedOutput.php
@@ -0,0 +1,55 @@
+<?php
+
+/**
+* This class extends UNL_Cache_Lite and uses output buffering to get the data to cache.
+* It supports nesting of caches
+*
+* @package UNL_Cache_Lite
+* @version $Id: NestedOutput.php 279664 2009-05-01 13:19:25Z tacker $
+* @author Markus Tacker <tacker@php.net>
+*/
+
+class UNL_Cache_Lite_NestedOutput extends UNL_Cache_Lite_Output
+{
+ private $nestedIds = array();
+ private $nestedGroups = array();
+
+ /**
+ * Start the cache
+ *
+ * @param string $id cache id
+ * @param string $group name of the cache group
+ * @param boolean $doNotTestCacheValidity if set to true, the cache validity won't be tested
+ * @return boolean|string false if the cache is not hit else the data
+ * @access public
+ */
+ function start($id, $group = 'default', $doNotTestCacheValidity = false)
+ {
+ $this->nestedIds[] = $id;
+ $this->nestedGroups[] = $group;
+ $data = $this->get($id, $group, $doNotTestCacheValidity);
+ if ($data !== false) {
+ return $data;
+ }
+ ob_start();
+ ob_implicit_flush(false);
+ return false;
+ }
+
+ /**
+ * Stop the cache
+ *
+ * @param boolen
+ * @return string return contents of cache
+ */
+ function end()
+ {
+ $data = ob_get_contents();
+ ob_end_clean();
+ $id = array_pop($this->nestedIds);
+ $group = array_pop($this->nestedGroups);
+ $this->save($data, $id, $group);
+ return $data;
+ }
+
+}
\ No newline at end of file
diff --git a/lib/php/UNL/Cache/Lite/Output.php b/lib/php/UNL/Cache/Lite/Output.php
new file mode 100644
index 00000000..9b9f45ff
--- /dev/null
+++ b/lib/php/UNL/Cache/Lite/Output.php
@@ -0,0 +1,70 @@
+<?php
+
+/**
+* This class extends UNL_Cache_Lite and uses output buffering to get the data to cache.
+*
+* There are some examples in the 'docs/examples' file
+* Technical choices are described in the 'docs/technical' file
+*
+* @package UNL_Cache_Lite
+* @version $Id: Output.php 206076 2006-01-29 00:22:07Z fab $
+* @author Fabien MARTY <fab@php.net>
+*/
+
+class UNL_Cache_Lite_Output extends UNL_Cache_Lite
+{
+
+ // --- Public methods ---
+
+ /**
+ * Constructor
+ *
+ * $options is an assoc. To have a look at availables options,
+ * see the constructor of the UNL_Cache_Lite class in 'UNL_Cache_Lite.php'
+ *
+ * @param array $options options
+ * @access public
+ */
+ function __construct($options = array(NULL))
+ {
+ $this->setOptions($options);
+ }
+
+ /**
+ * Start the cache
+ *
+ * @param string $id cache id
+ * @param string $group name of the cache group
+ * @param boolean $doNotTestCacheValidity if set to true, the cache validity won't be tested
+ * @return boolean true if the cache is hit (false else)
+ * @access public
+ */
+ function start($id, $group = 'default', $doNotTestCacheValidity = false)
+ {
+ $data = $this->get($id, $group, $doNotTestCacheValidity);
+ if ($data !== false) {
+ echo($data);
+ return true;
+ }
+ ob_start();
+ ob_implicit_flush(false);
+ return false;
+ }
+
+ /**
+ * Stop the cache
+ *
+ * @access public
+ */
+ function end()
+ {
+ $data = ob_get_contents();
+ ob_end_clean();
+ $this->save($data, $this->_id, $this->_group);
+ echo($data);
+ }
+
+}
+
+
+?>
--
GitLab