mirror_php/php-archive
1
0
Fork 0
mirror of https://github.com/splitbrain/php-archive.git synced 2025-07-10 17:36:27 +02:00
Code Issues Releases Wiki Activity
Files
gh-pages
php-archive/source-class-splitbrain.PHPArchive.Tar.html
ApiGen Github Bot eb002f5d3d 📖 #9 - ApiGen Code Docs Regenerated / ⚡ Triggered By d9d4eaac12
2024-12-09 14:09:57 +00:00

925 lines
141 KiB
HTML
Raw Permalink Blame History

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="robots" content="noindex">
<title>File Tar.php</title>
<link rel="stylesheet" href="resources/style.css?c2f33731c1948fbed7c333554678bfa68d4817da">
</head>
<body>
<div id="left">
<div id="menu">
<a href="index.html" title="Overview"><span>Overview</span></a>
<div id="groups">
<h3>Namespaces</h3>
<ul>
<li>
<a href="namespace-splitbrain.html">
splitbrain<span></span>
</a>
<ul>
<li>
<a href="namespace-splitbrain.PHPArchive.html">
PHPArchive </a>
</li>
</ul></li>
</ul>
</div>
<hr>
<div id="elements">
<h3>Classes</h3>
<ul>
<li><a href="class-splitbrain.PHPArchive.Archive.html">splitbrain\PHPArchive\Archive</a></li>
<li><a href="class-splitbrain.PHPArchive.FileInfo.html">splitbrain\PHPArchive\FileInfo</a></li>
<li><a href="class-splitbrain.PHPArchive.Tar.html">splitbrain\PHPArchive\Tar</a></li>
<li><a href="class-splitbrain.PHPArchive.Zip.html">splitbrain\PHPArchive\Zip</a></li>
</ul>
<h3>Exceptions</h3>
<ul>
<li><a href="class-splitbrain.PHPArchive.ArchiveCorruptedException.html">splitbrain\PHPArchive\ArchiveCorruptedException</a></li>
<li><a href="class-splitbrain.PHPArchive.ArchiveIllegalCompressionException.html">splitbrain\PHPArchive\ArchiveIllegalCompressionException</a></li>
<li><a href="class-splitbrain.PHPArchive.ArchiveIOException.html">splitbrain\PHPArchive\ArchiveIOException</a></li>
<li><a href="class-splitbrain.PHPArchive.FileInfoException.html">splitbrain\PHPArchive\FileInfoException</a></li>
</ul>
</div>
</div>
</div>
<div id="splitter"></div>
<div id="right">
<div id="rightInner">
<form id="search">
<input type="hidden" name="cx" value="">
<input type="hidden" name="ie" value="UTF-8">
<input type="text" name="q" class="text" placeholder="Search">
</form>
<div id="navigation">
<ul>
<li>
<a href="index.html" title="Overview"><span>Overview</span></a>
</li>
<li>
<span>Namespace</span> </li>
<li>
<span>Class</span> </li>
</ul>
<ul>
</ul>
<ul>
</ul>
</div>
<pre class="numbers"><code><span class="l"><a href="#1"> 1: </a></span><span class="l"><a href="#2"> 2: </a></span><span class="l"><a href="#3"> 3: </a></span><span class="l"><a href="#4"> 4: </a></span><span class="l"><a href="#5"> 5: </a></span></span><span class="l"><a href="#6"> 6: </a></span></span><span class="l"><a href="#7"> 7: </a></span></span><span class="l"><a href="#8"> 8: </a></span></span><span class="l"><a href="#9"> 9: </a></span></span><span class="l"><a href="#10"> 10: </a></span></span><span class="l"><a href="#11"> 11: </a></span></span><span class="l"><a href="#12"> 12: </a></span></span><span class="l"><a href="#13"> 13: </a></span></span><span class="l"><a href="#14"> 14: </a></span></span><span class="l"><a href="#15"> 15: </a></span><span class="l"><a href="#16"> 16: </a></span><span class="l"><a href="#17"> 17: </a></span><span class="l"><a href="#18"> 18: </a></span><span class="l"><a href="#19"> 19: </a></span><span class="l"><a href="#20"> 20: </a></span><span class="l"><a href="#21"> 21: </a></span><span class="l"><a href="#22"> 22: </a></span><span class="l"><a href="#23"> 23: </a></span><span class="l"><a href="#24"> 24: </a></span><span class="l"><a href="#25"> 25: </a></span><span class="l"><a href="#26"> 26: </a></span><span class="l"><a href="#27"> 27: </a></span><span class="l"><a href="#28"> 28: </a></span><span class="l"><a href="#29"> 29: </a></span><span class="l"><a href="#30"> 30: </a></span><span class="l"><a href="#31"> 31: </a></span></span><span class="l"><a href="#32"> 32: </a></span></span><span class="l"><a href="#33"> 33: </a></span></span><span class="l"><a href="#34"> 34: </a></span></span><span class="l"><a href="#35"> 35: </a></span></span><span class="l"><a href="#36"> 36: </a></span></span><span class="l"><a href="#37"> 37: </a></span><span class="l"><a href="#38"> 38: </a></span><span class="l"><a href="#39"> 39: </a></span><span class="l"><a href="#40"> 40: </a></span><span class="l"><a href="#41"> 41: </a></span><span class="l"><a href="#42"> 42: </a></span><span class="l"><a href="#43"> 43: </a></span><span class="l"><a href="#44"> 44: </a></span><span class="l"><a href="#45"> 45: </a></span><span class="l"><a href="#46"> 46: </a></span><span class="l"><a href="#47"> 47: </a></span><span class="l"><a href="#48"> 48: </a></span><span class="l"><a href="#49"> 49: </a></span><span class="l"><a href="#50"> 50: </a></span></span><span class="l"><a href="#51"> 51: </a></span></span><span class="l"><a href="#52"> 52: </a></span></span><span class="l"><a href="#53"> 53: </a></span></span><span class="l"><a href="#54"> 54: </a></span></span><span class="l"><a href="#55"> 55: </a></span></span><span class="l"><a href="#56"> 56: </a></span><span class="l"><a href="#57"> 57: </a></span><span class="l"><a href="#58"> 58: </a></span><span class="l"><a href="#59"> 59: </a></span><span class="l"><a href="#60"> 60: </a></span><span class="l"><a href="#61"> 61: </a></span><span class="l"><a href="#62"> 62: </a></span><span class="l"><a href="#63"> 63: </a></span><span class="l"><a href="#64"> 64: </a></span><span class="l"><a href="#65"> 65: </a></span><span class="l"><a href="#66"> 66: </a></span><span class="l"><a href="#67"> 67: </a></span><span class="l"><a href="#68"> 68: </a></span><span class="l"><a href="#69"> 69: </a></span><span class="l"><a href="#70"> 70: </a></span><span class="l"><a href="#71"> 71: </a></span><span class="l"><a href="#72"> 72: </a></span><span class="l"><a href="#73"> 73: </a></span><span class="l"><a href="#74"> 74: </a></span><span class="l"><a href="#75"> 75: </a></span><span class="l"><a href="#76"> 76: </a></span><span class="l"><a href="#77"> 77: </a></span><span class="l"><a href="#78"> 78: </a></span><span class="l"><a href="#79"> 79: </a></span><span class="l"><a href="#80"> 80: </a></span><span class="l"><a href="#81"> 81: </a></span><span class="l"><a href="#82"> 82: </a></span></span><span class="l"><a href="#83"> 83: </a></span></span><span class="l"><a href="#84"> 84: </a></span></span><span class="l"><a href="#85"> 85: </a></span></span><span class="l"><a href="#86"> 86: </a></span></span><span class="l"><a href="#87"> 87: </a></span></span><span class="l"><a href="#88"> 88: </a></span></span><span class="l"><a href="#89"> 89: </a></span></span><span class="l"><a href="#90"> 90: </a></span></span><span class="l"><a href="#91"> 91: </a></span></span><span class="l"><a href="#92"> 92: </a></span></span><span class="l"><a href="#93"> 93: </a></span><span class="l"><a href="#94"> 94: </a></span><span class="l"><a href="#95"> 95: </a></span><span class="l"><a href="#96"> 96: </a></span><span class="l"><a href="#97"> 97: </a></span><span class="l"><a href="#98"> 98: </a></span><span class="l"><a href="#99"> 99: </a></span><span class="l"><a href="#100">100: </a></span><span class="l"><a href="#101">101: </a></span><span class="l"><a href="#102">102: </a></span><span class="l"><a href="#103">103: </a></span><span class="l"><a href="#104">104: </a></span><span class="l"><a href="#105">105: </a></span></span><span class="l"><a href="#106">106: </a></span></span><span class="l"><a href="#107">107: </a></span></span><span class="l"><a href="#108">108: </a></span></span><span class="l"><a href="#109">109: </a></span></span><span class="l"><a href="#110">110: </a></span></span><span class="l"><a href="#111">111: </a></span></span><span class="l"><a href="#112">112: </a></span></span><span class="l"><a href="#113">113: </a></span><span class="l"><a href="#114">114: </a></span><span class="l"><a href="#115">115: </a></span><span class="l"><a href="#116">116: </a></span><span class="l"><a href="#117">117: </a></span><span class="l"><a href="#118">118: </a></span><span class="l"><a href="#119">119: </a></span><span class="l"><a href="#120">120: </a></span><span class="l"><a href="#121">121: </a></span><span class="l"><a href="#122">122: </a></span><span class="l"><a href="#123">123: </a></span><span class="l"><a href="#124">124: </a></span><span class="l"><a href="#125">125: </a></span><span class="l"><a href="#126">126: </a></span><span class="l"><a href="#127">127: </a></span><span class="l"><a href="#128">128: </a></span><span class="l"><a href="#129">129: </a></span><span class="l"><a href="#130">130: </a></span><span class="l"><a href="#131">131: </a></span><span class="l"><a href="#132">132: </a></span><span class="l"><a href="#133">133: </a></span><span class="l"><a href="#134">134: </a></span><span class="l"><a href="#135">135: </a></span><span class="l"><a href="#136">136: </a></span><span class="l"><a href="#137">137: </a></span><span class="l"><a href="#138">138: </a></span><span class="l"><a href="#139">139: </a></span><span class="l"><a href="#140">140: </a></span></span><span class="l"><a href="#141">141: </a></span></span><span class="l"><a href="#142">142: </a></span></span><span class="l"><a href="#143">143: </a></span></span><span class="l"><a href="#144">144: </a></span></span><span class="l"><a href="#145">145: </a></span></span><span class="l"><a href="#146">146: </a></span></span><span class="l"><a href="#147">147: </a></span></span><span class="l"><a href="#148">148: </a></span></span><span class="l"><a href="#149">149: </a></span><span class="l"><a href="#150">150: </a></span><span class="l"><a href="#151">151: </a></span><span class="l"><a href="#152">152: </a></span><span class="l"><a href="#153">153: </a></span><span class="l"><a href="#154">154: </a></span><span class="l"><a href="#155">155: </a></span><span class="l"><a href="#156">156: </a></span><span class="l"><a href="#157">157: </a></span><span class="l"><a href="#158">158: </a></span><span class="l"><a href="#159">159: </a></span></span><span class="l"><a href="#160">160: </a></span></span><span class="l"><a href="#161">161: </a></span></span><span class="l"><a href="#162">162: </a></span></span><span class="l"><a href="#163">163: </a></span></span><span class="l"><a href="#164">164: </a></span></span><span class="l"><a href="#165">165: </a></span></span><span class="l"><a href="#166">166: </a></span></span><span class="l"><a href="#167">167: </a></span></span><span class="l"><a href="#168">168: </a></span></span><span class="l"><a href="#169">169: </a></span></span><span class="l"><a href="#170">170: </a></span></span><span class="l"><a href="#171">171: </a></span></span><span class="l"><a href="#172">172: </a></span></span><span class="l"><a href="#173">173: </a></span></span><span class="l"><a href="#174">174: </a></span></span><span class="l"><a href="#175">175: </a></span></span><span class="l"><a href="#176">176: </a></span></span><span class="l"><a href="#177">177: </a></span></span><span class="l"><a href="#178">178: </a></span></span><span class="l"><a href="#179">179: </a></span></span><span class="l"><a href="#180">180: </a></span></span><span class="l"><a href="#181">181: </a></span></span><span class="l"><a href="#182">182: </a></span></span><span class="l"><a href="#183">183: </a></span></span><span class="l"><a href="#184">184: </a></span><span class="l"><a href="#185">185: </a></span><span class="l"><a href="#186">186: </a></span><span class="l"><a href="#187">187: </a></span><span class="l"><a href="#188">188: </a></span><span class="l"><a href="#189">189: </a></span><span class="l"><a href="#190">190: </a></span><span class="l"><a href="#191">191: </a></span><span class="l"><a href="#192">192: </a></span><span class="l"><a href="#193">193: </a></span><span class="l"><a href="#194">194: </a></span><span class="l"><a href="#195">195: </a></span><span class="l"><a href="#196">196: </a></span><span class="l"><a href="#197">197: </a></span><span class="l"><a href="#198">198: </a></span><span class="l"><a href="#199">199: </a></span><span class="l"><a href="#200">200: </a></span><span class="l"><a href="#201">201: </a></span><span class="l"><a href="#202">202: </a></span><span class="l"><a href="#203">203: </a></span><span class="l"><a href="#204">204: </a></span><span class="l"><a href="#205">205: </a></span><span class="l"><a href="#206">206: </a></span><span class="l"><a href="#207">207: </a></span><span class="l"><a href="#208">208: </a></span><span class="l"><a href="#209">209: </a></span><span class="l"><a href="#210">210: </a></span><span class="l"><a href="#211">211: </a></span><span class="l"><a href="#212">212: </a></span><span class="l"><a href="#213">213: </a></span><span class="l"><a href="#214">214: </a></span><span class="l"><a href="#215">215: </a></span><span class="l"><a href="#216">216: </a></span><span class="l"><a href="#217">217: </a></span><span class="l"><a href="#218">218: </a></span><span class="l"><a href="#219">219: </a></span><span class="l"><a href="#220">220: </a></span><span class="l"><a href="#221">221: </a></span><span class="l"><a href="#222">222: </a></span><span class="l"><a href="#223">223: </a></span><span class="l"><a href="#224">224: </a></span><span class="l"><a href="#225">225: </a></span><span class="l"><a href="#226">226: </a></span><span class="l"><a href="#227">227: </a></span><span class="l"><a href="#228">228: </a></span><span class="l"><a href="#229">229: </a></span><span class="l"><a href="#230">230: </a></span><span class="l"><a href="#231">231: </a></span><span class="l"><a href="#232">232: </a></span><span class="l"><a href="#233">233: </a></span><span class="l"><a href="#234">234: </a></span><span class="l"><a href="#235">235: </a></span><span class="l"><a href="#236">236: </a></span><span class="l"><a href="#237">237: </a></span><span class="l"><a href="#238">238: </a></span><span class="l"><a href="#239">239: </a></span><span class="l"><a href="#240">240: </a></span><span class="l"><a href="#241">241: </a></span><span class="l"><a href="#242">242: </a></span><span class="l"><a href="#243">243: </a></span><span class="l"><a href="#244">244: </a></span><span class="l"><a href="#245">245: </a></span><span class="l"><a href="#246">246: </a></span><span class="l"><a href="#247">247: </a></span><span class="l"><a href="#248">248: </a></span><span class="l"><a href="#249">249: </a></span><span class="l"><a href="#250">250: </a></span><span class="l"><a href="#251">251: </a></span><span class="l"><a href="#252">252: </a></span><span class="l"><a href="#253">253: </a></span><span class="l"><a href="#254">254: </a></span></span><span class="l"><a href="#255">255: </a></span></span><span class="l"><a href="#256">256: </a></span></span><span class="l"><a href="#257">257: </a></span></span><span class="l"><a href="#258">258: </a></span></span><span class="l"><a href="#259">259: </a></span></span><span class="l"><a href="#260">260: </a></span></span><span class="l"><a href="#261">261: </a></span></span><span class="l"><a href="#262">262: </a></span><span class="l"><a href="#263">263: </a></span><span class="l"><a href="#264">264: </a></span><span class="l"><a href="#265">265: </a></span><span class="l"><a href="#266">266: </a></span><span class="l"><a href="#267">267: </a></span><span class="l"><a href="#268">268: </a></span><span class="l"><a href="#269">269: </a></span><span class="l"><a href="#270">270: </a></span><span class="l"><a href="#271">271: </a></span><span class="l"><a href="#272">272: </a></span><span class="l"><a href="#273">273: </a></span><span class="l"><a href="#274">274: </a></span><span class="l"><a href="#275">275: </a></span><span class="l"><a href="#276">276: </a></span><span class="l"><a href="#277">277: </a></span><span class="l"><a href="#278">278: </a></span><span class="l"><a href="#279">279: </a></span><span class="l"><a href="#280">280: </a></span><span class="l"><a href="#281">281: </a></span><span class="l"><a href="#282">282: </a></span><span class="l"><a href="#283">283: </a></span><span class="l"><a href="#284">284: </a></span><span class="l"><a href="#285">285: </a></span><span class="l"><a href="#286">286: </a></span><span class="l"><a href="#287">287: </a></span><span class="l"><a href="#288">288: </a></span><span class="l"><a href="#289">289: </a></span><span class="l"><a href="#290">290: </a></span><span class="l"><a href="#291">291: </a></span></span><span class="l"><a href="#292">292: </a></span></span><span class="l"><a href="#293">293: </a></span></span><span class="l"><a href="#294">294: </a></span></span><span class="l"><a href="#295">295: </a></span></span><span class="l"><a href="#296">296: </a></span></span><span class="l"><a href="#297">297: </a></span></span><span class="l"><a href="#298">298: </a></span></span><span class="l"><a href="#299">299: </a></span><span class="l"><a href="#300">300: </a></span><span class="l"><a href="#301">301: </a></span><span class="l"><a href="#302">302: </a></span><span class="l"><a href="#303">303: </a></span><span class="l"><a href="#304">304: </a></span><span class="l"><a href="#305">305: </a></span><span class="l"><a href="#306">306: </a></span><span class="l"><a href="#307">307: </a></span><span class="l"><a href="#308">308: </a></span><span class="l"><a href="#309">309: </a></span><span class="l"><a href="#310">310: </a></span><span class="l"><a href="#311">311: </a></span><span class="l"><a href="#312">312: </a></span><span class="l"><a href="#313">313: </a></span><span class="l"><a href="#314">314: </a></span><span class="l"><a href="#315">315: </a></span><span class="l"><a href="#316">316: </a></span><span class="l"><a href="#317">317: </a></span><span class="l"><a href="#318">318: </a></span><span class="l"><a href="#319">319: </a></span><span class="l"><a href="#320">320: </a></span><span class="l"><a href="#321">321: </a></span><span class="l"><a href="#322">322: </a></span><span class="l"><a href="#323">323: </a></span><span class="l"><a href="#324">324: </a></span><span class="l"><a href="#325">325: </a></span><span class="l"><a href="#326">326: </a></span><span class="l"><a href="#327">327: </a></span><span class="l"><a href="#328">328: </a></span><span class="l"><a href="#329">329: </a></span><span class="l"><a href="#330">330: </a></span><span class="l"><a href="#331">331: </a></span><span class="l"><a href="#332">332: </a></span><span class="l"><a href="#333">333: </a></span><span class="l"><a href="#334">334: </a></span><span class="l"><a href="#335">335: </a></span><span class="l"><a href="#336">336: </a></span><span class="l"><a href="#337">337: </a></span><span class="l"><a href="#338">338: </a></span><span class="l"><a href="#339">339: </a></span><span class="l"><a href="#340">340: </a></span><span class="l"><a href="#341">341: </a></span><span class="l"><a href="#342">342: </a></span><span class="l"><a href="#343">343: </a></span><span class="l"><a href="#344">344: </a></span><span class="l"><a href="#345">345: </a></span><span class="l"><a href="#346">346: </a></span><span class="l"><a href="#347">347: </a></span><span class="l"><a href="#348">348: </a></span><span class="l"><a href="#349">349: </a></span><span class="l"><a href="#350">350: </a></span><span class="l"><a href="#351">351: </a></span><span class="l"><a href="#352">352: </a></span><span class="l"><a href="#353">353: </a></span><span class="l"><a href="#354">354: </a></span><span class="l"><a href="#355">355: </a></span><span class="l"><a href="#356">356: </a></span><span class="l"><a href="#357">357: </a></span><span class="l"><a href="#358">358: </a></span></span><span class="l"><a href="#359">359: </a></span></span><span class="l"><a href="#360">360: </a></span></span><span class="l"><a href="#361">361: </a></span></span><span class="l"><a href="#362">362: </a></span></span><span class="l"><a href="#363">363: </a></span></span><span class="l"><a href="#364">364: </a></span><span class="l"><a href="#365">365: </a></span><span class="l"><a href="#366">366: </a></span><span class="l"><a href="#367">367: </a></span><span class="l"><a href="#368">368: </a></span><span class="l"><a href="#369">369: </a></span><span class="l"><a href="#370">370: </a></span><span class="l"><a href="#371">371: </a></span><span class="l"><a href="#372">372: </a></span><span class="l"><a href="#373">373: </a></span><span class="l"><a href="#374">374: </a></span><span class="l"><a href="#375">375: </a></span><span class="l"><a href="#376">376: </a></span><span class="l"><a href="#377">377: </a></span><span class="l"><a href="#378">378: </a></span><span class="l"><a href="#379">379: </a></span><span class="l"><a href="#380">380: </a></span><span class="l"><a href="#381">381: </a></span><span class="l"><a href="#382">382: </a></span><span class="l"><a href="#383">383: </a></span><span class="l"><a href="#384">384: </a></span><span class="l"><a href="#385">385: </a></span><span class="l"><a href="#386">386: </a></span><span class="l"><a href="#387">387: </a></span><span class="l"><a href="#388">388: </a></span><span class="l"><a href="#389">389: </a></span><span class="l"><a href="#390">390: </a></span><span class="l"><a href="#391">391: </a></span></span><span class="l"><a href="#392">392: </a></span></span><span class="l"><a href="#393">393: </a></span></span><span class="l"><a href="#394">394: </a></span></span><span class="l"><a href="#395">395: </a></span></span><span class="l"><a href="#396">396: </a></span></span><span class="l"><a href="#397">397: </a></span></span><span class="l"><a href="#398">398: </a></span></span><span class="l"><a href="#399">399: </a></span></span><span class="l"><a href="#400">400: </a></span></span><span class="l"><a href="#401">401: </a></span></span><span class="l"><a href="#402">402: </a></span><span class="l"><a href="#403">403: </a></span><span class="l"><a href="#404">404: </a></span><span class="l"><a href="#405">405: </a></span><span class="l"><a href="#406">406: </a></span><span class="l"><a href="#407">407: </a></span><span class="l"><a href="#408">408: </a></span><span class="l"><a href="#409">409: </a></span><span class="l"><a href="#410">410: </a></span><span class="l"><a href="#411">411: </a></span><span class="l"><a href="#412">412: </a></span><span class="l"><a href="#413">413: </a></span><span class="l"><a href="#414">414: </a></span><span class="l"><a href="#415">415: </a></span><span class="l"><a href="#416">416: </a></span><span class="l"><a href="#417">417: </a></span><span class="l"><a href="#418">418: </a></span><span class="l"><a href="#419">419: </a></span><span class="l"><a href="#420">420: </a></span><span class="l"><a href="#421">421: </a></span><span class="l"><a href="#422">422: </a></span><span class="l"><a href="#423">423: </a></span><span class="l"><a href="#424">424: </a></span><span class="l"><a href="#425">425: </a></span><span class="l"><a href="#426">426: </a></span><span class="l"><a href="#427">427: </a></span><span class="l"><a href="#428">428: </a></span><span class="l"><a href="#429">429: </a></span><span class="l"><a href="#430">430: </a></span><span class="l"><a href="#431">431: </a></span><span class="l"><a href="#432">432: </a></span><span class="l"><a href="#433">433: </a></span></span><span class="l"><a href="#434">434: </a></span></span><span class="l"><a href="#435">435: </a></span></span><span class="l"><a href="#436">436: </a></span></span><span class="l"><a href="#437">437: </a></span></span><span class="l"><a href="#438">438: </a></span><span class="l"><a href="#439">439: </a></span><span class="l"><a href="#440">440: </a></span><span class="l"><a href="#441">441: </a></span><span class="l"><a href="#442">442: </a></span><span class="l"><a href="#443">443: </a></span><span class="l"><a href="#444">444: </a></span><span class="l"><a href="#445">445: </a></span><span class="l"><a href="#446">446: </a></span><span class="l"><a href="#447">447: </a></span><span class="l"><a href="#448">448: </a></span><span class="l"><a href="#449">449: </a></span><span class="l"><a href="#450">450: </a></span><span class="l"><a href="#451">451: </a></span><span class="l"><a href="#452">452: </a></span><span class="l"><a href="#453">453: </a></span><span class="l"><a href="#454">454: </a></span><span class="l"><a href="#455">455: </a></span><span class="l"><a href="#456">456: </a></span></span><span class="l"><a href="#457">457: </a></span></span><span class="l"><a href="#458">458: </a></span></span><span class="l"><a href="#459">459: </a></span></span><span class="l"><a href="#460">460: </a></span></span><span class="l"><a href="#461">461: </a></span></span><span class="l"><a href="#462">462: </a></span></span><span class="l"><a href="#463">463: </a></span></span><span class="l"><a href="#464">464: </a></span></span><span class="l"><a href="#465">465: </a></span><span class="l"><a href="#466">466: </a></span><span class="l"><a href="#467">467: </a></span><span class="l"><a href="#468">468: </a></span><span class="l"><a href="#469">469: </a></span><span class="l"><a href="#470">470: </a></span><span class="l"><a href="#471">471: </a></span><span class="l"><a href="#472">472: </a></span><span class="l"><a href="#473">473: </a></span><span class="l"><a href="#474">474: </a></span><span class="l"><a href="#475">475: </a></span><span class="l"><a href="#476">476: </a></span><span class="l"><a href="#477">477: </a></span></span><span class="l"><a href="#478">478: </a></span></span><span class="l"><a href="#479">479: </a></span></span><span class="l"><a href="#480">480: </a></span></span><span class="l"><a href="#481">481: </a></span></span><span class="l"><a href="#482">482: </a></span><span class="l"><a href="#483">483: </a></span><span class="l"><a href="#484">484: </a></span><span class="l"><a href="#485">485: </a></span><span class="l"><a href="#486">486: </a></span><span class="l"><a href="#487">487: </a></span><span class="l"><a href="#488">488: </a></span><span class="l"><a href="#489">489: </a></span><span class="l"><a href="#490">490: </a></span><span class="l"><a href="#491">491: </a></span><span class="l"><a href="#492">492: </a></span><span class="l"><a href="#493">493: </a></span><span class="l"><a href="#494">494: </a></span><span class="l"><a href="#495">495: </a></span><span class="l"><a href="#496">496: </a></span></span><span class="l"><a href="#497">497: </a></span></span><span class="l"><a href="#498">498: </a></span></span><span class="l"><a href="#499">499: </a></span></span><span class="l"><a href="#500">500: </a></span></span><span class="l"><a href="#501">501: </a></span></span><span class="l"><a href="#502">502: </a></span><span class="l"><a href="#503">503: </a></span><span class="l"><a href="#504">504: </a></span><span class="l"><a href="#505">505: </a></span><span class="l"><a href="#506">506: </a></span><span class="l"><a href="#507">507: </a></span><span class="l"><a href="#508">508: </a></span><span class="l"><a href="#509">509: </a></span><span class="l"><a href="#510">510: </a></span><span class="l"><a href="#511">511: </a></span><span class="l"><a href="#512">512: </a></span><span class="l"><a href="#513">513: </a></span><span class="l"><a href="#514">514: </a></span><span class="l"><a href="#515">515: </a></span><span class="l"><a href="#516">516: </a></span><span class="l"><a href="#517">517: </a></span><span class="l"><a href="#518">518: </a></span><span class="l"><a href="#519">519: </a></span><span class="l"><a href="#520">520: </a></span><span class="l"><a href="#521">521: </a></span></span><span class="l"><a href="#522">522: </a></span></span><span class="l"><a href="#523">523: </a></span></span><span class="l"><a href="#524">524: </a></span></span><span class="l"><a href="#525">525: </a></span></span><span class="l"><a href="#526">526: </a></span></span><span class="l"><a href="#527">527: </a></span><span class="l"><a href="#528">528: </a></span><span class="l"><a href="#529">529: </a></span><span class="l"><a href="#530">530: </a></span><span class="l"><a href="#531">531: </a></span><span class="l"><a href="#532">532: </a></span><span class="l"><a href="#533">533: </a></span><span class="l"><a href="#534">534: </a></span><span class="l"><a href="#535">535: </a></span><span class="l"><a href="#536">536: </a></span><span class="l"><a href="#537">537: </a></span><span class="l"><a href="#538">538: </a></span><span class="l"><a href="#539">539: </a></span><span class="l"><a href="#540">540: </a></span><span class="l"><a href="#541">541: </a></span><span class="l"><a href="#542">542: </a></span><span class="l"><a href="#543">543: </a></span><span class="l"><a href="#544">544: </a></span><span class="l"><a href="#545">545: </a></span><span class="l"><a href="#546">546: </a></span></span><span class="l"><a href="#547">547: </a></span></span><span class="l"><a href="#548">548: </a></span></span><span class="l"><a href="#549">549: </a></span></span><span class="l"><a href="#550">550: </a></span></span><span class="l"><a href="#551">551: </a></span><span class="l"><a href="#552">552: </a></span><span class="l"><a href="#553">553: </a></span><span class="l"><a href="#554">554: </a></span><span class="l"><a href="#555">555: </a></span><span class="l"><a href="#556">556: </a></span><span class="l"><a href="#557">557: </a></span><span class="l"><a href="#558">558: </a></span><span class="l"><a href="#559">559: </a></span><span class="l"><a href="#560">560: </a></span><span class="l"><a href="#561">561: </a></span><span class="l"><a href="#562">562: </a></span><span class="l"><a href="#563">563: </a></span><span class="l"><a href="#564">564: </a></span><span class="l"><a href="#565">565: </a></span></span><span class="l"><a href="#566">566: </a></span></span><span class="l"><a href="#567">567: </a></span></span><span class="l"><a href="#568">568: </a></span></span><span class="l"><a href="#569">569: </a></span></span><span class="l"><a href="#570">570: </a></span></span><span class="l"><a href="#571">571: </a></span></span><span class="l"><a href="#572">572: </a></span></span><span class="l"><a href="#573">573: </a></span></span><span class="l"><a href="#574">574: </a></span></span><span class="l"><a href="#575">575: </a></span></span><span class="l"><a href="#576">576: </a></span><span class="l"><a href="#577">577: </a></span><span class="l"><a href="#578">578: </a></span><span class="l"><a href="#579">579: </a></span><span class="l"><a href="#580">580: </a></span><span class="l"><a href="#581">581: </a></span><span class="l"><a href="#582">582: </a></span><span class="l"><a href="#583">583: </a></span><span class="l"><a href="#584">584: </a></span><span class="l"><a href="#585">585: </a></span><span class="l"><a href="#586">586: </a></span><span class="l"><a href="#587">587: </a></span><span class="l"><a href="#588">588: </a></span><span class="l"><a href="#589">589: </a></span><span class="l"><a href="#590">590: </a></span><span class="l"><a href="#591">591: </a></span><span class="l"><a href="#592">592: </a></span><span class="l"><a href="#593">593: </a></span><span class="l"><a href="#594">594: </a></span><span class="l"><a href="#595">595: </a></span><span class="l"><a href="#596">596: </a></span><span class="l"><a href="#597">597: </a></span><span class="l"><a href="#598">598: </a></span><span class="l"><a href="#599">599: </a></span><span class="l"><a href="#600">600: </a></span><span class="l"><a href="#601">601: </a></span><span class="l"><a href="#602">602: </a></span><span class="l"><a href="#603">603: </a></span><span class="l"><a href="#604">604: </a></span><span class="l"><a href="#605">605: </a></span><span class="l"><a href="#606">606: </a></span><span class="l"><a href="#607">607: </a></span><span class="l"><a href="#608">608: </a></span><span class="l"><a href="#609">609: </a></span><span class="l"><a href="#610">610: </a></span><span class="l"><a href="#611">611: </a></span><span class="l"><a href="#612">612: </a></span><span class="l"><a href="#613">613: </a></span><span class="l"><a href="#614">614: </a></span><span class="l"><a href="#615">615: </a></span><span class="l"><a href="#616">616: </a></span><span class="l"><a href="#617">617: </a></span><span class="l"><a href="#618">618: </a></span><span class="l"><a href="#619">619: </a></span><span class="l"><a href="#620">620: </a></span><span class="l"><a href="#621">621: </a></span><span class="l"><a href="#622">622: </a></span><span class="l"><a href="#623">623: </a></span></span><span class="l"><a href="#624">624: </a></span></span><span class="l"><a href="#625">625: </a></span></span><span class="l"><a href="#626">626: </a></span></span><span class="l"><a href="#627">627: </a></span></span><span class="l"><a href="#628">628: </a></span></span><span class="l"><a href="#629">629: </a></span><span class="l"><a href="#630">630: </a></span><span class="l"><a href="#631">631: </a></span><span class="l"><a href="#632">632: </a></span><span class="l"><a href="#633">633: </a></span><span class="l"><a href="#634">634: </a></span><span class="l"><a href="#635">635: </a></span><span class="l"><a href="#636">636: </a></span><span class="l"><a href="#637">637: </a></span><span class="l"><a href="#638">638: </a></span><span class="l"><a href="#639">639: </a></span><span class="l"><a href="#640">640: </a></span><span class="l"><a href="#641">641: </a></span><span class="l"><a href="#642">642: </a></span><span class="l"><a href="#643">643: </a></span><span class="l"><a href="#644">644: </a></span><span class="l"><a href="#645">645: </a></span><span class="l"><a href="#646">646: </a></span><span class="l"><a href="#647">647: </a></span><span class="l"><a href="#648">648: </a></span><span class="l"><a href="#649">649: </a></span><span class="l"><a href="#650">650: </a></span><span class="l"><a href="#651">651: </a></span><span class="l"><a href="#652">652: </a></span><span class="l"><a href="#653">653: </a></span><span class="l"><a href="#654">654: </a></span><span class="l"><a href="#655">655: </a></span><span class="l"><a href="#656">656: </a></span><span class="l"><a href="#657">657: </a></span><span class="l"><a href="#658">658: </a></span><span class="l"><a href="#659">659: </a></span><span class="l"><a href="#660">660: </a></span><span class="l"><a href="#661">661: </a></span><span class="l"><a href="#662">662: </a></span><span class="l"><a href="#663">663: </a></span><span class="l"><a href="#664">664: </a></span><span class="l"><a href="#665">665: </a></span><span class="l"><a href="#666">666: </a></span><span class="l"><a href="#667">667: </a></span><span class="l"><a href="#668">668: </a></span><span class="l"><a href="#669">669: </a></span><span class="l"><a href="#670">670: </a></span><span class="l"><a href="#671">671: </a></span><span class="l"><a href="#672">672: </a></span><span class="l"><a href="#673">673: </a></span><span class="l"><a href="#674">674: </a></span><span class="l"><a href="#675">675: </a></span><span class="l"><a href="#676">676: </a></span><span class="l"><a href="#677">677: </a></span><span class="l"><a href="#678">678: </a></span><span class="l"><a href="#679">679: </a></span><span class="l"><a href="#680">680: </a></span><span class="l"><a href="#681">681: </a></span><span class="l"><a href="#682">682: </a></span><span class="l"><a href="#683">683: </a></span><span class="l"><a href="#684">684: </a></span><span class="l"><a href="#685">685: </a></span><span class="l"><a href="#686">686: </a></span><span class="l"><a href="#687">687: </a></span><span class="l"><a href="#688">688: </a></span><span class="l"><a href="#689">689: </a></span><span class="l"><a href="#690">690: </a></span></span><span class="l"><a href="#691">691: </a></span></span><span class="l"><a href="#692">692: </a></span></span><span class="l"><a href="#693">693: </a></span></span><span class="l"><a href="#694">694: </a></span></span><span class="l"><a href="#695">695: </a></span><span class="l"><a href="#696">696: </a></span><span class="l"><a href="#697">697: </a></span><span class="l"><a href="#698">698: </a></span><span class="l"><a href="#699">699: </a></span><span class="l"><a href="#700">700: </a></span><span class="l"><a href="#701">701: </a></span><span class="l"><a href="#702">702: </a></span><span class="l"><a href="#703">703: </a></span><span class="l"><a href="#704">704: </a></span><span class="l"><a href="#705">705: </a></span><span class="l"><a href="#706">706: </a></span><span class="l"><a href="#707">707: </a></span><span class="l"><a href="#708">708: </a></span><span class="l"><a href="#709">709: </a></span><span class="l"><a href="#710">710: </a></span><span class="l"><a href="#711">711: </a></span><span class="l"><a href="#712">712: </a></span></span><span class="l"><a href="#713">713: </a></span></span><span class="l"><a href="#714">714: </a></span></span><span class="l"><a href="#715">715: </a></span></span><span class="l"><a href="#716">716: </a></span></span><span class="l"><a href="#717">717: </a></span><span class="l"><a href="#718">718: </a></span><span class="l"><a href="#719">719: </a></span><span class="l"><a href="#720">720: </a></span><span class="l"><a href="#721">721: </a></span><span class="l"><a href="#722">722: </a></span><span class="l"><a href="#723">723: </a></span><span class="l"><a href="#724">724: </a></span><span class="l"><a href="#725">725: </a></span><span class="l"><a href="#726">726: </a></span><span class="l"><a href="#727">727: </a></span><span class="l"><a href="#728">728: </a></span><span class="l"><a href="#729">729: </a></span></span><span class="l"><a href="#730">730: </a></span></span><span class="l"><a href="#731">731: </a></span></span><span class="l"><a href="#732">732: </a></span></span><span class="l"><a href="#733">733: </a></span></span><span class="l"><a href="#734">734: </a></span></span><span class="l"><a href="#735">735: </a></span></span><span class="l"><a href="#736">736: </a></span></span><span class="l"><a href="#737">737: </a></span></span><span class="l"><a href="#738">738: </a></span><span class="l"><a href="#739">739: </a></span><span class="l"><a href="#740">740: </a></span><span class="l"><a href="#741">741: </a></span><span class="l"><a href="#742">742: </a></span><span class="l"><a href="#743">743: </a></span><span class="l"><a href="#744">744: </a></span><span class="l"><a href="#745">745: </a></span><span class="l"><a href="#746">746: </a></span><span class="l"><a href="#747">747: </a></span><span class="l"><a href="#748">748: </a></span><span class="l"><a href="#749">749: </a></span><span class="l"><a href="#750">750: </a></span><span class="l"><a href="#751">751: </a></span><span class="l"><a href="#752">752: </a></span><span class="l"><a href="#753">753: </a></span><span class="l"><a href="#754">754: </a></span><span class="l"><a href="#755">755: </a></span><span class="l"><a href="#756">756: </a></span><span class="l"><a href="#757">757: </a></span><span class="l"><a href="#758">758: </a></span><span class="l"><a href="#759">759: </a></span><span class="l"><a href="#760">760: </a></span><span class="l"><a href="#761">761: </a></span><span class="l"><a href="#762">762: </a></span><span class="l"><a href="#763">763: </a></span></span><span class="l"><a href="#764">764: </a></span></span><span class="l"><a href="#765">765: </a></span></span><span class="l"><a href="#766">766: </a></span></span><span class="l"><a href="#767">767: </a></span></span><span class="l"><a href="#768">768: </a></span></span><span class="l"><a href="#769">769: </a></span></span><span class="l"><a href="#770">770: </a></span><span class="l"><a href="#771">771: </a></span><span class="l"><a href="#772">772: </a></span><span class="l"><a href="#773">773: </a></span><span class="l"><a href="#774">774: </a></span><span class="l"><a href="#775">775: </a></span><span class="l"><a href="#776">776: </a></span><span class="l"><a href="#777">777: </a></span><span class="l"><a href="#778">778: </a></span><span class="l"><a href="#779">779: </a></span><span class="l"><a href="#780">780: </a></span><span class="l"><a href="#781">781: </a></span><span class="l"><a href="#782">782: </a></span><span class="l"><a href="#783">783: </a></span><span class="l"><a href="#784">784: </a></span><span class="l"><a href="#785">785: </a></span><span class="l"><a href="#786">786: </a></span><span class="l"><a href="#787">787: </a></span><span class="l"><a href="#788">788: </a></span><span class="l"><a href="#789">789: </a></span><span class="l"><a href="#790">790: </a></span><span class="l"><a href="#791">791: </a></span><span class="l"><a href="#792">792: </a></span><span class="l"><a href="#793">793: </a></span><span class="l"><a href="#794">794: </a></span></span><span class="l"><a href="#795">795: </a></span></span><span class="l"><a href="#796">796: </a></span></span><span class="l"><a href="#797">797: </a></span></span><span class="l"><a href="#798">798: </a></span></span><span class="l"><a href="#799">799: </a></span></span><span class="l"><a href="#800">800: </a></span></span><span class="l"><a href="#801">801: </a></span></span><span class="l"><a href="#802">802: </a></span><span class="l"><a href="#803">803: </a></span><span class="l"><a href="#804">804: </a></span><span class="l"><a href="#805">805: </a></span><span class="l"><a href="#806">806: </a></span><span class="l"><a href="#807">807: </a></span><span class="l"><a href="#808">808: </a></span><span class="l"><a href="#809">809: </a></span><span class="l"><a href="#810">810: </a></span><span class="l"><a href="#811">811: </a></span><span class="l"><a href="#812">812: </a></span><span class="l"><a href="#813">813: </a></span><span class="l"><a href="#814">814: </a></span><span class="l"><a href="#815">815: </a></span><span class="l"><a href="#816">816: </a></span><span class="l"><a href="#817">817: </a></span><span class="l"><a href="#818">818: </a></span><span class="l"><a href="#819">819: </a></span><span class="l"><a href="#820">820: </a></span><span class="l"><a href="#821">821: </a></span><span class="l"><a href="#822">822: </a></span><span class="l"><a href="#823">823: </a></span><span class="l"><a href="#824">824: </a></span></code></pre>
<pre class="code"><code><span id="1" class="l"><span class="xlang">&lt;?php</span>
</span><span id="2" class="l">
</span><span id="3" class="l"><span class="php-keyword1">namespace</span> splitbrain\PHPArchive;
</span><span id="4" class="l">
</span><span id="5" class="l"><span class="php-comment">/**
</span></span><span id="6" class="l"><span class="php-comment"> * Class Tar
</span></span><span id="7" class="l"><span class="php-comment"> *
</span></span><span id="8" class="l"><span class="php-comment"> * Creates or extracts Tar archives. Supports gz and bzip compression
</span></span><span id="9" class="l"><span class="php-comment"> *
</span></span><span id="10" class="l"><span class="php-comment"> * Long pathnames (&gt;100 chars) are supported in POSIX ustar and GNU longlink formats.
</span></span><span id="11" class="l"><span class="php-comment"> *
</span></span><span id="12" class="l"><span class="php-comment"> * @author Andreas Gohr &lt;andi@splitbrain.org&gt;
</span></span><span id="13" class="l"><span class="php-comment"> * @package splitbrain\PHPArchive
</span></span><span id="14" class="l"><span class="php-comment"> * @license MIT
</span></span><span id="15" class="l"><span class="php-comment"> */</span>
</span><span id="16" class="l"><span class="php-keyword1">class</span> Tar <span class="php-keyword1">extends</span> Archive
</span><span id="17" class="l">{
</span><span id="18" class="l"> <span class="php-keyword1">const</span> READ_CHUNK_SIZE = <span class="php-num">1048576</span>; <span class="php-comment">// 1MB</span>
</span><span id="19" class="l">
</span><span id="20" class="l"> <span class="php-keyword1">protected</span> <span class="php-var">$file</span> = <span class="php-quote">''</span>;
</span><span id="21" class="l"> <span class="php-keyword1">protected</span> <span class="php-var">$comptype</span> = Archive::COMPRESS_AUTO;
</span><span id="22" class="l"> <span class="php-keyword1">protected</span> <span class="php-var">$complevel</span> = <span class="php-num">9</span>;
</span><span id="23" class="l"> <span class="php-keyword1">protected</span> <span class="php-var">$fh</span>;
</span><span id="24" class="l"> <span class="php-keyword1">protected</span> <span class="php-var">$memory</span> = <span class="php-quote">''</span>;
</span><span id="25" class="l"> <span class="php-keyword1">protected</span> <span class="php-var">$closed</span> = <span class="php-keyword1">true</span>;
</span><span id="26" class="l"> <span class="php-keyword1">protected</span> <span class="php-var">$writeaccess</span> = <span class="php-keyword1">false</span>;
</span><span id="27" class="l"> <span class="php-keyword1">protected</span> <span class="php-var">$position</span> = <span class="php-num">0</span>;
</span><span id="28" class="l"> <span class="php-keyword1">protected</span> <span class="php-var">$contentUntil</span> = <span class="php-num">0</span>;
</span><span id="29" class="l"> <span class="php-keyword1">protected</span> <span class="php-var">$skipUntil</span> = <span class="php-num">0</span>;
</span><span id="30" class="l">
</span><span id="31" class="l"> <span class="php-comment">/**
</span></span><span id="32" class="l"><span class="php-comment"> * Sets the compression to use
</span></span><span id="33" class="l"><span class="php-comment"> *
</span></span><span id="34" class="l"><span class="php-comment"> * @param int $level Compression level (0 to 9)
</span></span><span id="35" class="l"><span class="php-comment"> * @param int $type Type of compression to use (use COMPRESS_* constants)
</span></span><span id="36" class="l"><span class="php-comment"> * @throws ArchiveIllegalCompressionException
</span></span><span id="37" class="l"><span class="php-comment"> */</span>
</span><span id="38" class="l"> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> setCompression(<span class="php-var">$level</span> = <span class="php-num">9</span>, <span class="php-var">$type</span> = Archive::COMPRESS_AUTO)
</span><span id="39" class="l"> {
</span><span id="40" class="l"> <span class="php-var">$this</span>-&gt;compressioncheck(<span class="php-var">$type</span>);
</span><span id="41" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$level</span> &lt; -<span class="php-num">1</span> || <span class="php-var">$level</span> &gt; <span class="php-num">9</span>) {
</span><span id="42" class="l"> <span class="php-keyword1">throw</span> <span class="php-keyword1">new</span> ArchiveIllegalCompressionException(<span class="php-quote">'Compression level should be between -1 and 9'</span>);
</span><span id="43" class="l"> }
</span><span id="44" class="l"> <span class="php-var">$this</span>-&gt;comptype = <span class="php-var">$type</span>;
</span><span id="45" class="l"> <span class="php-var">$this</span>-&gt;complevel = <span class="php-var">$level</span>;
</span><span id="46" class="l"> <span class="php-keyword1">if</span>(<span class="php-var">$level</span> == <span class="php-num">0</span>) <span class="php-var">$this</span>-&gt;comptype = Archive::COMPRESS_NONE;
</span><span id="47" class="l"> <span class="php-keyword1">if</span>(<span class="php-var">$type</span> == Archive::COMPRESS_NONE) <span class="php-var">$this</span>-&gt;complevel = <span class="php-num">0</span>;
</span><span id="48" class="l"> }
</span><span id="49" class="l">
</span><span id="50" class="l"> <span class="php-comment">/**
</span></span><span id="51" class="l"><span class="php-comment"> * Open an existing TAR file for reading
</span></span><span id="52" class="l"><span class="php-comment"> *
</span></span><span id="53" class="l"><span class="php-comment"> * @param string $file
</span></span><span id="54" class="l"><span class="php-comment"> * @throws ArchiveIOException
</span></span><span id="55" class="l"><span class="php-comment"> * @throws ArchiveIllegalCompressionException
</span></span><span id="56" class="l"><span class="php-comment"> */</span>
</span><span id="57" class="l"> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> open(<span class="php-var">$file</span>)
</span><span id="58" class="l"> {
</span><span id="59" class="l"> <span class="php-var">$this</span>-&gt;<span class="php-keyword2">file</span> = <span class="php-var">$file</span>;
</span><span id="60" class="l">
</span><span id="61" class="l"> <span class="php-comment">// update compression to mach file</span>
</span><span id="62" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$this</span>-&gt;comptype == Tar::COMPRESS_AUTO) {
</span><span id="63" class="l"> <span class="php-var">$this</span>-&gt;setCompression(<span class="php-var">$this</span>-&gt;complevel, <span class="php-var">$this</span>-&gt;<span class="php-keyword2">filetype</span>(<span class="php-var">$file</span>));
</span><span id="64" class="l"> }
</span><span id="65" class="l">
</span><span id="66" class="l"> <span class="php-comment">// open file handles</span>
</span><span id="67" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$this</span>-&gt;comptype === Archive::COMPRESS_GZIP) {
</span><span id="68" class="l"> <span class="php-var">$this</span>-&gt;fh = @<span class="php-keyword2">gzopen</span>(<span class="php-var">$this</span>-&gt;<span class="php-keyword2">file</span>, <span class="php-quote">'rb'</span>);
</span><span id="69" class="l"> } <span class="php-keyword1">elseif</span> (<span class="php-var">$this</span>-&gt;comptype === Archive::COMPRESS_BZIP) {
</span><span id="70" class="l"> <span class="php-var">$this</span>-&gt;fh = @<span class="php-keyword2">bzopen</span>(<span class="php-var">$this</span>-&gt;<span class="php-keyword2">file</span>, <span class="php-quote">'r'</span>);
</span><span id="71" class="l"> } <span class="php-keyword1">else</span> {
</span><span id="72" class="l"> <span class="php-var">$this</span>-&gt;fh = @<span class="php-keyword2">fopen</span>(<span class="php-var">$this</span>-&gt;<span class="php-keyword2">file</span>, <span class="php-quote">'rb'</span>);
</span><span id="73" class="l"> }
</span><span id="74" class="l">
</span><span id="75" class="l"> <span class="php-keyword1">if</span> (!<span class="php-var">$this</span>-&gt;fh) {
</span><span id="76" class="l"> <span class="php-keyword1">throw</span> <span class="php-keyword1">new</span> ArchiveIOException(<span class="php-quote">'Could not open file for reading: '</span>.<span class="php-var">$this</span>-&gt;<span class="php-keyword2">file</span>);
</span><span id="77" class="l"> }
</span><span id="78" class="l"> <span class="php-var">$this</span>-&gt;closed = <span class="php-keyword1">false</span>;
</span><span id="79" class="l"> <span class="php-var">$this</span>-&gt;position = <span class="php-num">0</span>;
</span><span id="80" class="l"> }
</span><span id="81" class="l">
</span><span id="82" class="l"> <span class="php-comment">/**
</span></span><span id="83" class="l"><span class="php-comment"> * Read the contents of a TAR archive
</span></span><span id="84" class="l"><span class="php-comment"> *
</span></span><span id="85" class="l"><span class="php-comment"> * This function lists the files stored in the archive
</span></span><span id="86" class="l"><span class="php-comment"> *
</span></span><span id="87" class="l"><span class="php-comment"> * The archive is closed afer reading the contents, because rewinding is not possible in bzip2 streams.
</span></span><span id="88" class="l"><span class="php-comment"> * Reopen the file with open() again if you want to do additional operations
</span></span><span id="89" class="l"><span class="php-comment"> *
</span></span><span id="90" class="l"><span class="php-comment"> * @throws ArchiveIOException
</span></span><span id="91" class="l"><span class="php-comment"> * @throws ArchiveCorruptedException
</span></span><span id="92" class="l"><span class="php-comment"> * @returns FileInfo[]
</span></span><span id="93" class="l"><span class="php-comment"> */</span>
</span><span id="94" class="l"> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> contents()
</span><span id="95" class="l"> {
</span><span id="96" class="l"> <span class="php-var">$result</span> = <span class="php-keyword1">array</span>();
</span><span id="97" class="l">
</span><span id="98" class="l"> <span class="php-keyword1">foreach</span> (<span class="php-var">$this</span>-&gt;yieldContents() <span class="php-keyword1">as</span> <span class="php-var">$fileinfo</span>) {
</span><span id="99" class="l"> <span class="php-var">$result</span>[] = <span class="php-var">$fileinfo</span>;
</span><span id="100" class="l"> }
</span><span id="101" class="l">
</span><span id="102" class="l"> <span class="php-keyword1">return</span> <span class="php-var">$result</span>;
</span><span id="103" class="l"> }
</span><span id="104" class="l">
</span><span id="105" class="l"> <span class="php-comment">/**
</span></span><span id="106" class="l"><span class="php-comment"> * Read the contents of a TAR archive and return each entry using yield
</span></span><span id="107" class="l"><span class="php-comment"> * for memory efficiency.
</span></span><span id="108" class="l"><span class="php-comment"> *
</span></span><span id="109" class="l"><span class="php-comment"> * @see contents()
</span></span><span id="110" class="l"><span class="php-comment"> * @throws ArchiveIOException
</span></span><span id="111" class="l"><span class="php-comment"> * @throws ArchiveCorruptedException
</span></span><span id="112" class="l"><span class="php-comment"> * @returns FileInfo[]
</span></span><span id="113" class="l"><span class="php-comment"> */</span>
</span><span id="114" class="l"> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> yieldContents()
</span><span id="115" class="l"> {
</span><span id="116" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$this</span>-&gt;closed || !<span class="php-var">$this</span>-&gt;<span class="php-keyword2">file</span>) {
</span><span id="117" class="l"> <span class="php-keyword1">throw</span> <span class="php-keyword1">new</span> ArchiveIOException(<span class="php-quote">'Can not read from a closed archive'</span>);
</span><span id="118" class="l"> }
</span><span id="119" class="l">
</span><span id="120" class="l"> <span class="php-keyword1">while</span> (<span class="php-var">$read</span> = <span class="php-var">$this</span>-&gt;readbytes(<span class="php-num">512</span>)) {
</span><span id="121" class="l"> <span class="php-var">$header</span> = <span class="php-var">$this</span>-&gt;parseHeader(<span class="php-var">$read</span>);
</span><span id="122" class="l"> <span class="php-keyword1">if</span> (!<span class="php-keyword2">is_array</span>(<span class="php-var">$header</span>)) {
</span><span id="123" class="l"> <span class="php-keyword1">continue</span>;
</span><span id="124" class="l"> }
</span><span id="125" class="l">
</span><span id="126" class="l"> <span class="php-var">$this</span>-&gt;contentUntil = <span class="php-var">$this</span>-&gt;position + <span class="php-var">$header</span>[<span class="php-quote">'size'</span>];
</span><span id="127" class="l"> <span class="php-var">$this</span>-&gt;skipUntil = <span class="php-var">$this</span>-&gt;position + <span class="php-keyword2">ceil</span>(<span class="php-var">$header</span>[<span class="php-quote">'size'</span>] / <span class="php-num">512</span>) * <span class="php-num">512</span>;
</span><span id="128" class="l">
</span><span id="129" class="l"> yield <span class="php-var">$this</span>-&gt;header2fileinfo(<span class="php-var">$header</span>);
</span><span id="130" class="l">
</span><span id="131" class="l"> <span class="php-var">$skip</span> = <span class="php-var">$this</span>-&gt;skipUntil - <span class="php-var">$this</span>-&gt;position;
</span><span id="132" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$skip</span> &gt; <span class="php-num">0</span>) {
</span><span id="133" class="l"> <span class="php-var">$this</span>-&gt;skipbytes(<span class="php-var">$skip</span>);
</span><span id="134" class="l"> }
</span><span id="135" class="l"> }
</span><span id="136" class="l">
</span><span id="137" class="l"> <span class="php-var">$this</span>-&gt;close();
</span><span id="138" class="l"> }
</span><span id="139" class="l">
</span><span id="140" class="l"> <span class="php-comment">/**
</span></span><span id="141" class="l"><span class="php-comment"> * Reads content of a current archive entry.
</span></span><span id="142" class="l"><span class="php-comment"> *
</span></span><span id="143" class="l"><span class="php-comment"> * Works only when iterating trough the archive using the generator returned
</span></span><span id="144" class="l"><span class="php-comment"> * by the yieldContents().
</span></span><span id="145" class="l"><span class="php-comment"> *
</span></span><span id="146" class="l"><span class="php-comment"> * @param int $length maximum number of bytes to read
</span></span><span id="147" class="l"><span class="php-comment"> *
</span></span><span id="148" class="l"><span class="php-comment"> * @return string
</span></span><span id="149" class="l"><span class="php-comment"> */</span>
</span><span id="150" class="l"> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> readCurrentEntry(<span class="php-var">$length</span> = PHP_INT_MAX)
</span><span id="151" class="l"> {
</span><span id="152" class="l"> <span class="php-var">$length</span> = (int) <span class="php-keyword2">min</span>(<span class="php-var">$length</span>, <span class="php-var">$this</span>-&gt;contentUntil - <span class="php-var">$this</span>-&gt;position);
</span><span id="153" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$length</span> === <span class="php-num">0</span>) {
</span><span id="154" class="l"> <span class="php-keyword1">return</span> <span class="php-quote">''</span>;
</span><span id="155" class="l"> }
</span><span id="156" class="l"> <span class="php-keyword1">return</span> <span class="php-var">$this</span>-&gt;readbytes(<span class="php-var">$length</span>);
</span><span id="157" class="l"> }
</span><span id="158" class="l">
</span><span id="159" class="l"> <span class="php-comment">/**
</span></span><span id="160" class="l"><span class="php-comment"> * Extract an existing TAR archive
</span></span><span id="161" class="l"><span class="php-comment"> *
</span></span><span id="162" class="l"><span class="php-comment"> * The $strip parameter allows you to strip a certain number of path components from the filenames
</span></span><span id="163" class="l"><span class="php-comment"> * found in the tar file, similar to the --strip-components feature of GNU tar. This is triggered when
</span></span><span id="164" class="l"><span class="php-comment"> * an integer is passed as $strip.
</span></span><span id="165" class="l"><span class="php-comment"> * Alternatively a fixed string prefix may be passed in $strip. If the filename matches this prefix,
</span></span><span id="166" class="l"><span class="php-comment"> * the prefix will be stripped. It is recommended to give prefixes with a trailing slash.
</span></span><span id="167" class="l"><span class="php-comment"> *
</span></span><span id="168" class="l"><span class="php-comment"> * By default this will extract all files found in the archive. You can restrict the output using the $include
</span></span><span id="169" class="l"><span class="php-comment"> * and $exclude parameter. Both expect a full regular expression (including delimiters and modifiers). If
</span></span><span id="170" class="l"><span class="php-comment"> * $include is set only files that match this expression will be extracted. Files that match the $exclude
</span></span><span id="171" class="l"><span class="php-comment"> * expression will never be extracted. Both parameters can be used in combination. Expressions are matched against
</span></span><span id="172" class="l"><span class="php-comment"> * stripped filenames as described above.
</span></span><span id="173" class="l"><span class="php-comment"> *
</span></span><span id="174" class="l"><span class="php-comment"> * The archive is closed afer reading the contents, because rewinding is not possible in bzip2 streams.
</span></span><span id="175" class="l"><span class="php-comment"> * Reopen the file with open() again if you want to do additional operations
</span></span><span id="176" class="l"><span class="php-comment"> *
</span></span><span id="177" class="l"><span class="php-comment"> * @param string $outdir the target directory for extracting
</span></span><span id="178" class="l"><span class="php-comment"> * @param int|string $strip either the number of path components or a fixed prefix to strip
</span></span><span id="179" class="l"><span class="php-comment"> * @param string $exclude a regular expression of files to exclude
</span></span><span id="180" class="l"><span class="php-comment"> * @param string $include a regular expression of files to include
</span></span><span id="181" class="l"><span class="php-comment"> * @throws ArchiveIOException
</span></span><span id="182" class="l"><span class="php-comment"> * @throws ArchiveCorruptedException
</span></span><span id="183" class="l"><span class="php-comment"> * @return FileInfo[]
</span></span><span id="184" class="l"><span class="php-comment"> */</span>
</span><span id="185" class="l"> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <span class="php-keyword2">extract</span>(<span class="php-var">$outdir</span>, <span class="php-var">$strip</span> = <span class="php-quote">''</span>, <span class="php-var">$exclude</span> = <span class="php-quote">''</span>, <span class="php-var">$include</span> = <span class="php-quote">''</span>)
</span><span id="186" class="l"> {
</span><span id="187" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$this</span>-&gt;closed || !<span class="php-var">$this</span>-&gt;<span class="php-keyword2">file</span>) {
</span><span id="188" class="l"> <span class="php-keyword1">throw</span> <span class="php-keyword1">new</span> ArchiveIOException(<span class="php-quote">'Can not read from a closed archive'</span>);
</span><span id="189" class="l"> }
</span><span id="190" class="l">
</span><span id="191" class="l"> <span class="php-var">$outdir</span> = <span class="php-keyword2">rtrim</span>(<span class="php-var">$outdir</span>, <span class="php-quote">'/'</span>);
</span><span id="192" class="l"> @<span class="php-keyword2">mkdir</span>(<span class="php-var">$outdir</span>, <span class="php-num">0777</span>, <span class="php-keyword1">true</span>);
</span><span id="193" class="l"> <span class="php-keyword1">if</span> (!<span class="php-keyword2">is_dir</span>(<span class="php-var">$outdir</span>)) {
</span><span id="194" class="l"> <span class="php-keyword1">throw</span> <span class="php-keyword1">new</span> ArchiveIOException(<span class="php-quote">&quot;Could not create directory '</span><span class="php-var">$outdir</span><span class="php-quote">'&quot;</span>);
</span><span id="195" class="l"> }
</span><span id="196" class="l">
</span><span id="197" class="l"> <span class="php-var">$extracted</span> = <span class="php-keyword1">array</span>();
</span><span id="198" class="l"> <span class="php-keyword1">while</span> (<span class="php-var">$dat</span> = <span class="php-var">$this</span>-&gt;readbytes(<span class="php-num">512</span>)) {
</span><span id="199" class="l"> <span class="php-comment">// read the file header</span>
</span><span id="200" class="l"> <span class="php-var">$header</span> = <span class="php-var">$this</span>-&gt;parseHeader(<span class="php-var">$dat</span>);
</span><span id="201" class="l"> <span class="php-keyword1">if</span> (!<span class="php-keyword2">is_array</span>(<span class="php-var">$header</span>)) {
</span><span id="202" class="l"> <span class="php-keyword1">continue</span>;
</span><span id="203" class="l"> }
</span><span id="204" class="l"> <span class="php-var">$fileinfo</span> = <span class="php-var">$this</span>-&gt;header2fileinfo(<span class="php-var">$header</span>);
</span><span id="205" class="l">
</span><span id="206" class="l"> <span class="php-comment">// apply strip rules</span>
</span><span id="207" class="l"> <span class="php-var">$fileinfo</span>-&gt;strip(<span class="php-var">$strip</span>);
</span><span id="208" class="l">
</span><span id="209" class="l"> <span class="php-comment">// skip unwanted files</span>
</span><span id="210" class="l"> <span class="php-keyword1">if</span> (!<span class="php-keyword2">strlen</span>(<span class="php-var">$fileinfo</span>-&gt;getPath()) || !<span class="php-var">$fileinfo</span>-&gt;matchExpression(<span class="php-var">$include</span>, <span class="php-var">$exclude</span>)) {
</span><span id="211" class="l"> <span class="php-var">$this</span>-&gt;skipbytes(<span class="php-keyword2">ceil</span>(<span class="php-var">$header</span>[<span class="php-quote">'size'</span>] / <span class="php-num">512</span>) * <span class="php-num">512</span>);
</span><span id="212" class="l"> <span class="php-keyword1">continue</span>;
</span><span id="213" class="l"> }
</span><span id="214" class="l">
</span><span id="215" class="l"> <span class="php-comment">// create output directory</span>
</span><span id="216" class="l"> <span class="php-var">$output</span> = <span class="php-var">$outdir</span>.<span class="php-quote">'/'</span>.<span class="php-var">$fileinfo</span>-&gt;getPath();
</span><span id="217" class="l"> <span class="php-var">$directory</span> = (<span class="php-var">$fileinfo</span>-&gt;getIsdir()) ? <span class="php-var">$output</span> : <span class="php-keyword2">dirname</span>(<span class="php-var">$output</span>);
</span><span id="218" class="l"> <span class="php-keyword1">if</span> (!<span class="php-keyword2">file_exists</span>(<span class="php-var">$directory</span>)) {
</span><span id="219" class="l"> <span class="php-keyword2">mkdir</span>(<span class="php-var">$directory</span>, <span class="php-num">0777</span>, <span class="php-keyword1">true</span>);
</span><span id="220" class="l"> }
</span><span id="221" class="l">
</span><span id="222" class="l"> <span class="php-comment">// extract data</span>
</span><span id="223" class="l"> <span class="php-keyword1">if</span> (!<span class="php-var">$fileinfo</span>-&gt;getIsdir()) {
</span><span id="224" class="l"> <span class="php-var">$fp</span> = @<span class="php-keyword2">fopen</span>(<span class="php-var">$output</span>, <span class="php-quote">&quot;wb&quot;</span>);
</span><span id="225" class="l"> <span class="php-keyword1">if</span> (!<span class="php-var">$fp</span>) {
</span><span id="226" class="l"> <span class="php-keyword1">throw</span> <span class="php-keyword1">new</span> ArchiveIOException(<span class="php-quote">'Could not open file for writing: '</span>.<span class="php-var">$output</span>);
</span><span id="227" class="l"> }
</span><span id="228" class="l">
</span><span id="229" class="l"> <span class="php-var">$size</span> = <span class="php-keyword2">floor</span>(<span class="php-var">$header</span>[<span class="php-quote">'size'</span>] / <span class="php-num">512</span>);
</span><span id="230" class="l"> <span class="php-keyword1">for</span> (<span class="php-var">$i</span> = <span class="php-num">0</span>; <span class="php-var">$i</span> &lt; <span class="php-var">$size</span>; <span class="php-var">$i</span>++) {
</span><span id="231" class="l"> <span class="php-keyword2">fwrite</span>(<span class="php-var">$fp</span>, <span class="php-var">$this</span>-&gt;readbytes(<span class="php-num">512</span>), <span class="php-num">512</span>);
</span><span id="232" class="l"> }
</span><span id="233" class="l"> <span class="php-keyword1">if</span> ((<span class="php-var">$header</span>[<span class="php-quote">'size'</span>] % <span class="php-num">512</span>) != <span class="php-num">0</span>) {
</span><span id="234" class="l"> <span class="php-keyword2">fwrite</span>(<span class="php-var">$fp</span>, <span class="php-var">$this</span>-&gt;readbytes(<span class="php-num">512</span>), <span class="php-var">$header</span>[<span class="php-quote">'size'</span>] % <span class="php-num">512</span>);
</span><span id="235" class="l"> }
</span><span id="236" class="l">
</span><span id="237" class="l"> <span class="php-keyword2">fclose</span>(<span class="php-var">$fp</span>);
</span><span id="238" class="l"> @<span class="php-keyword2">touch</span>(<span class="php-var">$output</span>, <span class="php-var">$fileinfo</span>-&gt;getMtime());
</span><span id="239" class="l"> @<span class="php-keyword2">chmod</span>(<span class="php-var">$output</span>, <span class="php-var">$fileinfo</span>-&gt;getMode());
</span><span id="240" class="l"> } <span class="php-keyword1">else</span> {
</span><span id="241" class="l"> <span class="php-var">$this</span>-&gt;skipbytes(<span class="php-keyword2">ceil</span>(<span class="php-var">$header</span>[<span class="php-quote">'size'</span>] / <span class="php-num">512</span>) * <span class="php-num">512</span>); <span class="php-comment">// the size is usually 0 for directories</span>
</span><span id="242" class="l"> }
</span><span id="243" class="l">
</span><span id="244" class="l"> <span class="php-keyword1">if</span>(<span class="php-keyword2">is_callable</span>(<span class="php-var">$this</span>-&gt;callback)) {
</span><span id="245" class="l"> <span class="php-keyword2">call_user_func</span>(<span class="php-var">$this</span>-&gt;callback, <span class="php-var">$fileinfo</span>);
</span><span id="246" class="l"> }
</span><span id="247" class="l"> <span class="php-var">$extracted</span>[] = <span class="php-var">$fileinfo</span>;
</span><span id="248" class="l"> }
</span><span id="249" class="l">
</span><span id="250" class="l"> <span class="php-var">$this</span>-&gt;close();
</span><span id="251" class="l"> <span class="php-keyword1">return</span> <span class="php-var">$extracted</span>;
</span><span id="252" class="l"> }
</span><span id="253" class="l">
</span><span id="254" class="l"> <span class="php-comment">/**
</span></span><span id="255" class="l"><span class="php-comment"> * Create a new TAR file
</span></span><span id="256" class="l"><span class="php-comment"> *
</span></span><span id="257" class="l"><span class="php-comment"> * If $file is empty, the tar file will be created in memory
</span></span><span id="258" class="l"><span class="php-comment"> *
</span></span><span id="259" class="l"><span class="php-comment"> * @param string $file
</span></span><span id="260" class="l"><span class="php-comment"> * @throws ArchiveIOException
</span></span><span id="261" class="l"><span class="php-comment"> * @throws ArchiveIllegalCompressionException
</span></span><span id="262" class="l"><span class="php-comment"> */</span>
</span><span id="263" class="l"> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> create(<span class="php-var">$file</span> = <span class="php-quote">''</span>)
</span><span id="264" class="l"> {
</span><span id="265" class="l"> <span class="php-var">$this</span>-&gt;<span class="php-keyword2">file</span> = <span class="php-var">$file</span>;
</span><span id="266" class="l"> <span class="php-var">$this</span>-&gt;memory = <span class="php-quote">''</span>;
</span><span id="267" class="l"> <span class="php-var">$this</span>-&gt;fh = <span class="php-num">0</span>;
</span><span id="268" class="l">
</span><span id="269" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$this</span>-&gt;<span class="php-keyword2">file</span>) {
</span><span id="270" class="l"> <span class="php-comment">// determine compression</span>
</span><span id="271" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$this</span>-&gt;comptype == Archive::COMPRESS_AUTO) {
</span><span id="272" class="l"> <span class="php-var">$this</span>-&gt;setCompression(<span class="php-var">$this</span>-&gt;complevel, <span class="php-var">$this</span>-&gt;<span class="php-keyword2">filetype</span>(<span class="php-var">$file</span>));
</span><span id="273" class="l"> }
</span><span id="274" class="l">
</span><span id="275" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$this</span>-&gt;comptype === Archive::COMPRESS_GZIP) {
</span><span id="276" class="l"> <span class="php-var">$this</span>-&gt;fh = @<span class="php-keyword2">gzopen</span>(<span class="php-var">$this</span>-&gt;<span class="php-keyword2">file</span>, <span class="php-quote">'wb'</span>.<span class="php-var">$this</span>-&gt;complevel);
</span><span id="277" class="l"> } <span class="php-keyword1">elseif</span> (<span class="php-var">$this</span>-&gt;comptype === Archive::COMPRESS_BZIP) {
</span><span id="278" class="l"> <span class="php-var">$this</span>-&gt;fh = @<span class="php-keyword2">bzopen</span>(<span class="php-var">$this</span>-&gt;<span class="php-keyword2">file</span>, <span class="php-quote">'w'</span>);
</span><span id="279" class="l"> } <span class="php-keyword1">else</span> {
</span><span id="280" class="l"> <span class="php-var">$this</span>-&gt;fh = @<span class="php-keyword2">fopen</span>(<span class="php-var">$this</span>-&gt;<span class="php-keyword2">file</span>, <span class="php-quote">'wb'</span>);
</span><span id="281" class="l"> }
</span><span id="282" class="l">
</span><span id="283" class="l"> <span class="php-keyword1">if</span> (!<span class="php-var">$this</span>-&gt;fh) {
</span><span id="284" class="l"> <span class="php-keyword1">throw</span> <span class="php-keyword1">new</span> ArchiveIOException(<span class="php-quote">'Could not open file for writing: '</span>.<span class="php-var">$this</span>-&gt;<span class="php-keyword2">file</span>);
</span><span id="285" class="l"> }
</span><span id="286" class="l"> }
</span><span id="287" class="l"> <span class="php-var">$this</span>-&gt;writeaccess = <span class="php-keyword1">true</span>;
</span><span id="288" class="l"> <span class="php-var">$this</span>-&gt;closed = <span class="php-keyword1">false</span>;
</span><span id="289" class="l"> }
</span><span id="290" class="l">
</span><span id="291" class="l"> <span class="php-comment">/**
</span></span><span id="292" class="l"><span class="php-comment"> * Add a file to the current TAR archive using an existing file in the filesystem
</span></span><span id="293" class="l"><span class="php-comment"> *
</span></span><span id="294" class="l"><span class="php-comment"> * @param string $file path to the original file
</span></span><span id="295" class="l"><span class="php-comment"> * @param string|FileInfo $fileinfo either the name to us in archive (string) or a FileInfo oject with all meta data, empty to take from original
</span></span><span id="296" class="l"><span class="php-comment"> * @throws ArchiveCorruptedException when the file changes while reading it, the archive will be corrupt and should be deleted
</span></span><span id="297" class="l"><span class="php-comment"> * @throws ArchiveIOException there was trouble reading the given file, it was not added
</span></span><span id="298" class="l"><span class="php-comment"> * @throws FileInfoException trouble reading file info, it was not added
</span></span><span id="299" class="l"><span class="php-comment"> */</span>
</span><span id="300" class="l"> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> addFile(<span class="php-var">$file</span>, <span class="php-var">$fileinfo</span> = <span class="php-quote">''</span>)
</span><span id="301" class="l"> {
</span><span id="302" class="l"> <span class="php-keyword1">if</span> (<span class="php-keyword2">is_string</span>(<span class="php-var">$fileinfo</span>)) {
</span><span id="303" class="l"> <span class="php-var">$fileinfo</span> = FileInfo::fromPath(<span class="php-var">$file</span>, <span class="php-var">$fileinfo</span>);
</span><span id="304" class="l"> }
</span><span id="305" class="l">
</span><span id="306" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$this</span>-&gt;closed) {
</span><span id="307" class="l"> <span class="php-keyword1">throw</span> <span class="php-keyword1">new</span> ArchiveIOException(<span class="php-quote">'Archive has been closed, files can no longer be added'</span>);
</span><span id="308" class="l"> }
</span><span id="309" class="l">
</span><span id="310" class="l"> <span class="php-comment">// create file header</span>
</span><span id="311" class="l"> <span class="php-var">$this</span>-&gt;writeFileHeader(<span class="php-var">$fileinfo</span>);
</span><span id="312" class="l">
</span><span id="313" class="l"> <span class="php-comment">// write data, but only if we have data to write.</span>
</span><span id="314" class="l"> <span class="php-comment">// note: on Windows fopen() on a directory will fail, so we prevent</span>
</span><span id="315" class="l"> <span class="php-comment">// errors on Windows by testing if we have data to write.</span>
</span><span id="316" class="l"> <span class="php-keyword1">if</span> (!<span class="php-var">$fileinfo</span>-&gt;getIsdir() &amp;&amp; <span class="php-var">$fileinfo</span>-&gt;getSize() &gt; <span class="php-num">0</span>) {
</span><span id="317" class="l"> <span class="php-var">$read</span> = <span class="php-num">0</span>;
</span><span id="318" class="l"> <span class="php-var">$fp</span> = @<span class="php-keyword2">fopen</span>(<span class="php-var">$file</span>, <span class="php-quote">'rb'</span>);
</span><span id="319" class="l"> <span class="php-keyword1">if</span> (!<span class="php-var">$fp</span>) {
</span><span id="320" class="l"> <span class="php-keyword1">throw</span> <span class="php-keyword1">new</span> ArchiveIOException(<span class="php-quote">'Could not open file for reading: '</span> . <span class="php-var">$file</span>);
</span><span id="321" class="l"> }
</span><span id="322" class="l"> <span class="php-keyword1">while</span> (!<span class="php-keyword2">feof</span>(<span class="php-var">$fp</span>)) {
</span><span id="323" class="l"> <span class="php-comment">// for performance reasons read bigger chunks at once</span>
</span><span id="324" class="l"> <span class="php-var">$data</span> = <span class="php-keyword2">fread</span>(<span class="php-var">$fp</span>, self::READ_CHUNK_SIZE);
</span><span id="325" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$data</span> === <span class="php-keyword1">false</span>) {
</span><span id="326" class="l"> <span class="php-keyword1">break</span>;
</span><span id="327" class="l"> }
</span><span id="328" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$data</span> === <span class="php-quote">''</span>) {
</span><span id="329" class="l"> <span class="php-keyword1">break</span>;
</span><span id="330" class="l"> }
</span><span id="331" class="l"> <span class="php-var">$dataLen</span> = <span class="php-keyword2">strlen</span>(<span class="php-var">$data</span>);
</span><span id="332" class="l"> <span class="php-var">$read</span> += <span class="php-var">$dataLen</span>;
</span><span id="333" class="l"> <span class="php-comment">// how much of data read fully fills 512-byte blocks?</span>
</span><span id="334" class="l"> <span class="php-var">$passLen</span> = (<span class="php-var">$dataLen</span> &gt;&gt; <span class="php-num">9</span>) &lt;&lt; <span class="php-num">9</span>;
</span><span id="335" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$passLen</span> === <span class="php-var">$dataLen</span>) {
</span><span id="336" class="l"> <span class="php-comment">// all - just write the data</span>
</span><span id="337" class="l"> <span class="php-var">$this</span>-&gt;writebytes(<span class="php-var">$data</span>);
</span><span id="338" class="l"> } <span class="php-keyword1">else</span> {
</span><span id="339" class="l"> <span class="php-comment">// directly write what fills 512-byte blocks fully</span>
</span><span id="340" class="l"> <span class="php-var">$this</span>-&gt;writebytes(<span class="php-keyword2">substr</span>(<span class="php-var">$data</span>, <span class="php-num">0</span>, <span class="php-var">$passLen</span>));
</span><span id="341" class="l"> <span class="php-comment">// pad the reminder to 512 bytes</span>
</span><span id="342" class="l"> <span class="php-var">$this</span>-&gt;writebytes(<span class="php-keyword2">pack</span>(<span class="php-quote">&quot;a512&quot;</span>, <span class="php-keyword2">substr</span>(<span class="php-var">$data</span>, <span class="php-var">$passLen</span>)));
</span><span id="343" class="l"> }
</span><span id="344" class="l"> }
</span><span id="345" class="l"> <span class="php-keyword2">fclose</span>(<span class="php-var">$fp</span>);
</span><span id="346" class="l">
</span><span id="347" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$read</span> != <span class="php-var">$fileinfo</span>-&gt;getSize()) {
</span><span id="348" class="l"> <span class="php-var">$this</span>-&gt;close();
</span><span id="349" class="l"> <span class="php-keyword1">throw</span> <span class="php-keyword1">new</span> ArchiveCorruptedException(<span class="php-quote">&quot;The size of </span><span class="php-var">$file</span><span class="php-quote"> changed while reading, archive corrupted. read </span><span class="php-var">$read</span><span class="php-quote"> expected &quot;</span>.<span class="php-var">$fileinfo</span>-&gt;getSize());
</span><span id="350" class="l"> }
</span><span id="351" class="l"> }
</span><span id="352" class="l">
</span><span id="353" class="l"> <span class="php-keyword1">if</span>(<span class="php-keyword2">is_callable</span>(<span class="php-var">$this</span>-&gt;callback)) {
</span><span id="354" class="l"> <span class="php-keyword2">call_user_func</span>(<span class="php-var">$this</span>-&gt;callback, <span class="php-var">$fileinfo</span>);
</span><span id="355" class="l"> }
</span><span id="356" class="l"> }
</span><span id="357" class="l">
</span><span id="358" class="l"> <span class="php-comment">/**
</span></span><span id="359" class="l"><span class="php-comment"> * Add a file to the current TAR archive using the given $data as content
</span></span><span id="360" class="l"><span class="php-comment"> *
</span></span><span id="361" class="l"><span class="php-comment"> * @param string|FileInfo $fileinfo either the name to us in archive (string) or a FileInfo oject with all meta data
</span></span><span id="362" class="l"><span class="php-comment"> * @param string $data binary content of the file to add
</span></span><span id="363" class="l"><span class="php-comment"> * @throws ArchiveIOException
</span></span><span id="364" class="l"><span class="php-comment"> */</span>
</span><span id="365" class="l"> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> addData(<span class="php-var">$fileinfo</span>, <span class="php-var">$data</span>)
</span><span id="366" class="l"> {
</span><span id="367" class="l"> <span class="php-keyword1">if</span> (<span class="php-keyword2">is_string</span>(<span class="php-var">$fileinfo</span>)) {
</span><span id="368" class="l"> <span class="php-var">$fileinfo</span> = <span class="php-keyword1">new</span> FileInfo(<span class="php-var">$fileinfo</span>);
</span><span id="369" class="l"> }
</span><span id="370" class="l">
</span><span id="371" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$this</span>-&gt;closed) {
</span><span id="372" class="l"> <span class="php-keyword1">throw</span> <span class="php-keyword1">new</span> ArchiveIOException(<span class="php-quote">'Archive has been closed, files can no longer be added'</span>);
</span><span id="373" class="l"> }
</span><span id="374" class="l">
</span><span id="375" class="l"> <span class="php-var">$len</span> = <span class="php-keyword2">strlen</span>(<span class="php-var">$data</span>);
</span><span id="376" class="l"> <span class="php-var">$fileinfo</span>-&gt;setSize(<span class="php-var">$len</span>);
</span><span id="377" class="l"> <span class="php-var">$this</span>-&gt;writeFileHeader(<span class="php-var">$fileinfo</span>);
</span><span id="378" class="l">
</span><span id="379" class="l"> <span class="php-comment">// write directly everything but the last block which needs padding</span>
</span><span id="380" class="l"> <span class="php-var">$passLen</span> = (<span class="php-var">$len</span> &gt;&gt; <span class="php-num">9</span>) &lt;&lt; <span class="php-num">9</span>;
</span><span id="381" class="l"> <span class="php-var">$this</span>-&gt;writebytes(<span class="php-keyword2">substr</span>(<span class="php-var">$data</span>, <span class="php-num">0</span>, <span class="php-var">$passLen</span>));
</span><span id="382" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$passLen</span> &lt; <span class="php-var">$len</span>) {
</span><span id="383" class="l"> <span class="php-var">$this</span>-&gt;writebytes(<span class="php-keyword2">pack</span>(<span class="php-quote">&quot;a512&quot;</span>, <span class="php-keyword2">substr</span>(<span class="php-var">$data</span>, <span class="php-var">$passLen</span>, <span class="php-num">512</span>)));
</span><span id="384" class="l"> }
</span><span id="385" class="l">
</span><span id="386" class="l"> <span class="php-keyword1">if</span> (<span class="php-keyword2">is_callable</span>(<span class="php-var">$this</span>-&gt;callback)) {
</span><span id="387" class="l"> <span class="php-keyword2">call_user_func</span>(<span class="php-var">$this</span>-&gt;callback, <span class="php-var">$fileinfo</span>);
</span><span id="388" class="l"> }
</span><span id="389" class="l"> }
</span><span id="390" class="l">
</span><span id="391" class="l"> <span class="php-comment">/**
</span></span><span id="392" class="l"><span class="php-comment"> * Add the closing footer to the archive if in write mode, close all file handles
</span></span><span id="393" class="l"><span class="php-comment"> *
</span></span><span id="394" class="l"><span class="php-comment"> * After a call to this function no more data can be added to the archive, for
</span></span><span id="395" class="l"><span class="php-comment"> * read access no reading is allowed anymore
</span></span><span id="396" class="l"><span class="php-comment"> *
</span></span><span id="397" class="l"><span class="php-comment"> * &quot;Physically, an archive consists of a series of file entries terminated by an end-of-archive entry, which
</span></span><span id="398" class="l"><span class="php-comment"> * consists of two 512 blocks of zero bytes&quot;
</span></span><span id="399" class="l"><span class="php-comment"> *
</span></span><span id="400" class="l"><span class="php-comment"> * @link http://www.gnu.org/software/tar/manual/html_chapter/tar_8.html#SEC134
</span></span><span id="401" class="l"><span class="php-comment"> * @throws ArchiveIOException
</span></span><span id="402" class="l"><span class="php-comment"> */</span>
</span><span id="403" class="l"> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> close()
</span><span id="404" class="l"> {
</span><span id="405" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$this</span>-&gt;closed) {
</span><span id="406" class="l"> <span class="php-keyword1">return</span>;
</span><span id="407" class="l"> } <span class="php-comment">// we did this already</span>
</span><span id="408" class="l">
</span><span id="409" class="l"> <span class="php-comment">// write footer</span>
</span><span id="410" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$this</span>-&gt;writeaccess) {
</span><span id="411" class="l"> <span class="php-var">$this</span>-&gt;writebytes(<span class="php-keyword2">pack</span>(<span class="php-quote">&quot;a512&quot;</span>, <span class="php-quote">&quot;&quot;</span>));
</span><span id="412" class="l"> <span class="php-var">$this</span>-&gt;writebytes(<span class="php-keyword2">pack</span>(<span class="php-quote">&quot;a512&quot;</span>, <span class="php-quote">&quot;&quot;</span>));
</span><span id="413" class="l"> }
</span><span id="414" class="l">
</span><span id="415" class="l"> <span class="php-comment">// close file handles</span>
</span><span id="416" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$this</span>-&gt;<span class="php-keyword2">file</span>) {
</span><span id="417" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$this</span>-&gt;comptype === Archive::COMPRESS_GZIP) {
</span><span id="418" class="l"> <span class="php-keyword2">gzclose</span>(<span class="php-var">$this</span>-&gt;fh);
</span><span id="419" class="l"> } <span class="php-keyword1">elseif</span> (<span class="php-var">$this</span>-&gt;comptype === Archive::COMPRESS_BZIP) {
</span><span id="420" class="l"> <span class="php-keyword2">bzclose</span>(<span class="php-var">$this</span>-&gt;fh);
</span><span id="421" class="l"> } <span class="php-keyword1">else</span> {
</span><span id="422" class="l"> <span class="php-keyword2">fclose</span>(<span class="php-var">$this</span>-&gt;fh);
</span><span id="423" class="l"> }
</span><span id="424" class="l">
</span><span id="425" class="l"> <span class="php-var">$this</span>-&gt;<span class="php-keyword2">file</span> = <span class="php-quote">''</span>;
</span><span id="426" class="l"> <span class="php-var">$this</span>-&gt;fh = <span class="php-num">0</span>;
</span><span id="427" class="l"> }
</span><span id="428" class="l">
</span><span id="429" class="l"> <span class="php-var">$this</span>-&gt;writeaccess = <span class="php-keyword1">false</span>;
</span><span id="430" class="l"> <span class="php-var">$this</span>-&gt;closed = <span class="php-keyword1">true</span>;
</span><span id="431" class="l"> }
</span><span id="432" class="l">
</span><span id="433" class="l"> <span class="php-comment">/**
</span></span><span id="434" class="l"><span class="php-comment"> * Returns the created in-memory archive data
</span></span><span id="435" class="l"><span class="php-comment"> *
</span></span><span id="436" class="l"><span class="php-comment"> * This implicitly calls close() on the Archive
</span></span><span id="437" class="l"><span class="php-comment"> * @throws ArchiveIOException
</span></span><span id="438" class="l"><span class="php-comment"> */</span>
</span><span id="439" class="l"> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> getArchive()
</span><span id="440" class="l"> {
</span><span id="441" class="l"> <span class="php-var">$this</span>-&gt;close();
</span><span id="442" class="l">
</span><span id="443" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$this</span>-&gt;comptype === Archive::COMPRESS_AUTO) {
</span><span id="444" class="l"> <span class="php-var">$this</span>-&gt;comptype = Archive::COMPRESS_NONE;
</span><span id="445" class="l"> }
</span><span id="446" class="l">
</span><span id="447" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$this</span>-&gt;comptype === Archive::COMPRESS_GZIP) {
</span><span id="448" class="l"> <span class="php-keyword1">return</span> <span class="php-keyword2">gzencode</span>(<span class="php-var">$this</span>-&gt;memory, <span class="php-var">$this</span>-&gt;complevel);
</span><span id="449" class="l"> }
</span><span id="450" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$this</span>-&gt;comptype === Archive::COMPRESS_BZIP) {
</span><span id="451" class="l"> <span class="php-keyword1">return</span> <span class="php-keyword2">bzcompress</span>(<span class="php-var">$this</span>-&gt;memory);
</span><span id="452" class="l"> }
</span><span id="453" class="l"> <span class="php-keyword1">return</span> <span class="php-var">$this</span>-&gt;memory;
</span><span id="454" class="l"> }
</span><span id="455" class="l">
</span><span id="456" class="l"> <span class="php-comment">/**
</span></span><span id="457" class="l"><span class="php-comment"> * Save the created in-memory archive data
</span></span><span id="458" class="l"><span class="php-comment"> *
</span></span><span id="459" class="l"><span class="php-comment"> * Note: It more memory effective to specify the filename in the create() function and
</span></span><span id="460" class="l"><span class="php-comment"> * let the library work on the new file directly.
</span></span><span id="461" class="l"><span class="php-comment"> *
</span></span><span id="462" class="l"><span class="php-comment"> * @param string $file
</span></span><span id="463" class="l"><span class="php-comment"> * @throws ArchiveIOException
</span></span><span id="464" class="l"><span class="php-comment"> * @throws ArchiveIllegalCompressionException
</span></span><span id="465" class="l"><span class="php-comment"> */</span>
</span><span id="466" class="l"> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> save(<span class="php-var">$file</span>)
</span><span id="467" class="l"> {
</span><span id="468" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$this</span>-&gt;comptype === Archive::COMPRESS_AUTO) {
</span><span id="469" class="l"> <span class="php-var">$this</span>-&gt;setCompression(<span class="php-var">$this</span>-&gt;complevel, <span class="php-var">$this</span>-&gt;<span class="php-keyword2">filetype</span>(<span class="php-var">$file</span>));
</span><span id="470" class="l"> }
</span><span id="471" class="l">
</span><span id="472" class="l"> <span class="php-keyword1">if</span> (!@<span class="php-keyword2">file_put_contents</span>(<span class="php-var">$file</span>, <span class="php-var">$this</span>-&gt;getArchive())) {
</span><span id="473" class="l"> <span class="php-keyword1">throw</span> <span class="php-keyword1">new</span> ArchiveIOException(<span class="php-quote">'Could not write to file: '</span>.<span class="php-var">$file</span>);
</span><span id="474" class="l"> }
</span><span id="475" class="l"> }
</span><span id="476" class="l">
</span><span id="477" class="l"> <span class="php-comment">/**
</span></span><span id="478" class="l"><span class="php-comment"> * Read from the open file pointer
</span></span><span id="479" class="l"><span class="php-comment"> *
</span></span><span id="480" class="l"><span class="php-comment"> * @param int $length bytes to read
</span></span><span id="481" class="l"><span class="php-comment"> * @return string
</span></span><span id="482" class="l"><span class="php-comment"> */</span>
</span><span id="483" class="l"> <span class="php-keyword1">protected</span> <span class="php-keyword1">function</span> readbytes(<span class="php-var">$length</span>)
</span><span id="484" class="l"> {
</span><span id="485" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$this</span>-&gt;comptype === Archive::COMPRESS_GZIP) {
</span><span id="486" class="l"> <span class="php-var">$ret</span> = @<span class="php-keyword2">gzread</span>(<span class="php-var">$this</span>-&gt;fh, <span class="php-var">$length</span>);
</span><span id="487" class="l"> } <span class="php-keyword1">elseif</span> (<span class="php-var">$this</span>-&gt;comptype === Archive::COMPRESS_BZIP) {
</span><span id="488" class="l"> <span class="php-var">$ret</span> = @<span class="php-keyword2">bzread</span>(<span class="php-var">$this</span>-&gt;fh, <span class="php-var">$length</span>);
</span><span id="489" class="l"> } <span class="php-keyword1">else</span> {
</span><span id="490" class="l"> <span class="php-var">$ret</span> = @<span class="php-keyword2">fread</span>(<span class="php-var">$this</span>-&gt;fh, <span class="php-var">$length</span>);
</span><span id="491" class="l"> }
</span><span id="492" class="l"> <span class="php-var">$this</span>-&gt;position += <span class="php-keyword2">strlen</span>(<span class="php-var">$ret</span>);
</span><span id="493" class="l"> <span class="php-keyword1">return</span> <span class="php-var">$ret</span>;
</span><span id="494" class="l"> }
</span><span id="495" class="l">
</span><span id="496" class="l"> <span class="php-comment">/**
</span></span><span id="497" class="l"><span class="php-comment"> * Write to the open filepointer or memory
</span></span><span id="498" class="l"><span class="php-comment"> *
</span></span><span id="499" class="l"><span class="php-comment"> * @param string $data
</span></span><span id="500" class="l"><span class="php-comment"> * @throws ArchiveIOException
</span></span><span id="501" class="l"><span class="php-comment"> * @return int number of bytes written
</span></span><span id="502" class="l"><span class="php-comment"> */</span>
</span><span id="503" class="l"> <span class="php-keyword1">protected</span> <span class="php-keyword1">function</span> writebytes(<span class="php-var">$data</span>)
</span><span id="504" class="l"> {
</span><span id="505" class="l"> <span class="php-keyword1">if</span> (!<span class="php-var">$this</span>-&gt;<span class="php-keyword2">file</span>) {
</span><span id="506" class="l"> <span class="php-var">$this</span>-&gt;memory .= <span class="php-var">$data</span>;
</span><span id="507" class="l"> <span class="php-var">$written</span> = <span class="php-keyword2">strlen</span>(<span class="php-var">$data</span>);
</span><span id="508" class="l"> } <span class="php-keyword1">elseif</span> (<span class="php-var">$this</span>-&gt;comptype === Archive::COMPRESS_GZIP) {
</span><span id="509" class="l"> <span class="php-var">$written</span> = @<span class="php-keyword2">gzwrite</span>(<span class="php-var">$this</span>-&gt;fh, <span class="php-var">$data</span>);
</span><span id="510" class="l"> } <span class="php-keyword1">elseif</span> (<span class="php-var">$this</span>-&gt;comptype === Archive::COMPRESS_BZIP) {
</span><span id="511" class="l"> <span class="php-var">$written</span> = @<span class="php-keyword2">bzwrite</span>(<span class="php-var">$this</span>-&gt;fh, <span class="php-var">$data</span>);
</span><span id="512" class="l"> } <span class="php-keyword1">else</span> {
</span><span id="513" class="l"> <span class="php-var">$written</span> = @<span class="php-keyword2">fwrite</span>(<span class="php-var">$this</span>-&gt;fh, <span class="php-var">$data</span>);
</span><span id="514" class="l"> }
</span><span id="515" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$written</span> === <span class="php-keyword1">false</span>) {
</span><span id="516" class="l"> <span class="php-keyword1">throw</span> <span class="php-keyword1">new</span> ArchiveIOException(<span class="php-quote">'Failed to write to archive stream'</span>);
</span><span id="517" class="l"> }
</span><span id="518" class="l"> <span class="php-keyword1">return</span> <span class="php-var">$written</span>;
</span><span id="519" class="l"> }
</span><span id="520" class="l">
</span><span id="521" class="l"> <span class="php-comment">/**
</span></span><span id="522" class="l"><span class="php-comment"> * Skip forward in the open file pointer
</span></span><span id="523" class="l"><span class="php-comment"> *
</span></span><span id="524" class="l"><span class="php-comment"> * This is basically a wrapper around seek() (and a workaround for bzip2)
</span></span><span id="525" class="l"><span class="php-comment"> *
</span></span><span id="526" class="l"><span class="php-comment"> * @param int $bytes seek to this position
</span></span><span id="527" class="l"><span class="php-comment"> */</span>
</span><span id="528" class="l"> <span class="php-keyword1">protected</span> <span class="php-keyword1">function</span> skipbytes(<span class="php-var">$bytes</span>)
</span><span id="529" class="l"> {
</span><span id="530" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$this</span>-&gt;comptype === Archive::COMPRESS_GZIP) {
</span><span id="531" class="l"> @<span class="php-keyword2">gzseek</span>(<span class="php-var">$this</span>-&gt;fh, <span class="php-var">$bytes</span>, SEEK_CUR);
</span><span id="532" class="l"> } <span class="php-keyword1">elseif</span> (<span class="php-var">$this</span>-&gt;comptype === Archive::COMPRESS_BZIP) {
</span><span id="533" class="l"> <span class="php-comment">// there is no seek in bzip2, we simply read on</span>
</span><span id="534" class="l"> <span class="php-comment">// bzread allows to read a max of 8kb at once</span>
</span><span id="535" class="l"> <span class="php-keyword1">while</span>(<span class="php-var">$bytes</span>) {
</span><span id="536" class="l"> <span class="php-var">$toread</span> = <span class="php-keyword2">min</span>(<span class="php-num">8192</span>, <span class="php-var">$bytes</span>);
</span><span id="537" class="l"> @<span class="php-keyword2">bzread</span>(<span class="php-var">$this</span>-&gt;fh, <span class="php-var">$toread</span>);
</span><span id="538" class="l"> <span class="php-var">$bytes</span> -= <span class="php-var">$toread</span>;
</span><span id="539" class="l"> }
</span><span id="540" class="l"> } <span class="php-keyword1">else</span> {
</span><span id="541" class="l"> @<span class="php-keyword2">fseek</span>(<span class="php-var">$this</span>-&gt;fh, <span class="php-var">$bytes</span>, SEEK_CUR);
</span><span id="542" class="l"> }
</span><span id="543" class="l"> <span class="php-var">$this</span>-&gt;position += <span class="php-var">$bytes</span>;
</span><span id="544" class="l"> }
</span><span id="545" class="l">
</span><span id="546" class="l"> <span class="php-comment">/**
</span></span><span id="547" class="l"><span class="php-comment"> * Write the given file meta data as header
</span></span><span id="548" class="l"><span class="php-comment"> *
</span></span><span id="549" class="l"><span class="php-comment"> * @param FileInfo $fileinfo
</span></span><span id="550" class="l"><span class="php-comment"> * @throws ArchiveIOException
</span></span><span id="551" class="l"><span class="php-comment"> */</span>
</span><span id="552" class="l"> <span class="php-keyword1">protected</span> <span class="php-keyword1">function</span> writeFileHeader(FileInfo <span class="php-var">$fileinfo</span>)
</span><span id="553" class="l"> {
</span><span id="554" class="l"> <span class="php-var">$this</span>-&gt;writeRawFileHeader(
</span><span id="555" class="l"> <span class="php-var">$fileinfo</span>-&gt;getPath(),
</span><span id="556" class="l"> <span class="php-var">$fileinfo</span>-&gt;getUid(),
</span><span id="557" class="l"> <span class="php-var">$fileinfo</span>-&gt;getGid(),
</span><span id="558" class="l"> <span class="php-var">$fileinfo</span>-&gt;getMode(),
</span><span id="559" class="l"> <span class="php-var">$fileinfo</span>-&gt;getSize(),
</span><span id="560" class="l"> <span class="php-var">$fileinfo</span>-&gt;getMtime(),
</span><span id="561" class="l"> <span class="php-var">$fileinfo</span>-&gt;getIsdir() ? <span class="php-quote">'5'</span> : <span class="php-quote">'0'</span>
</span><span id="562" class="l"> );
</span><span id="563" class="l"> }
</span><span id="564" class="l">
</span><span id="565" class="l"> <span class="php-comment">/**
</span></span><span id="566" class="l"><span class="php-comment"> * Write a file header to the stream
</span></span><span id="567" class="l"><span class="php-comment"> *
</span></span><span id="568" class="l"><span class="php-comment"> * @param string $name
</span></span><span id="569" class="l"><span class="php-comment"> * @param int $uid
</span></span><span id="570" class="l"><span class="php-comment"> * @param int $gid
</span></span><span id="571" class="l"><span class="php-comment"> * @param int $perm
</span></span><span id="572" class="l"><span class="php-comment"> * @param int $size
</span></span><span id="573" class="l"><span class="php-comment"> * @param int $mtime
</span></span><span id="574" class="l"><span class="php-comment"> * @param string $typeflag Set to '5' for directories
</span></span><span id="575" class="l"><span class="php-comment"> * @throws ArchiveIOException
</span></span><span id="576" class="l"><span class="php-comment"> */</span>
</span><span id="577" class="l"> <span class="php-keyword1">protected</span> <span class="php-keyword1">function</span> writeRawFileHeader(<span class="php-var">$name</span>, <span class="php-var">$uid</span>, <span class="php-var">$gid</span>, <span class="php-var">$perm</span>, <span class="php-var">$size</span>, <span class="php-var">$mtime</span>, <span class="php-var">$typeflag</span> = <span class="php-quote">''</span>)
</span><span id="578" class="l"> {
</span><span id="579" class="l"> <span class="php-comment">// handle filename length restrictions</span>
</span><span id="580" class="l"> <span class="php-var">$prefix</span> = <span class="php-quote">''</span>;
</span><span id="581" class="l"> <span class="php-var">$namelen</span> = <span class="php-keyword2">strlen</span>(<span class="php-var">$name</span>);
</span><span id="582" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$namelen</span> &gt; <span class="php-num">100</span>) {
</span><span id="583" class="l"> <span class="php-var">$file</span> = <span class="php-keyword2">basename</span>(<span class="php-var">$name</span>);
</span><span id="584" class="l"> <span class="php-var">$dir</span> = <span class="php-keyword2">dirname</span>(<span class="php-var">$name</span>);
</span><span id="585" class="l"> <span class="php-keyword1">if</span> (<span class="php-keyword2">strlen</span>(<span class="php-var">$file</span>) &gt; <span class="php-num">100</span> || <span class="php-keyword2">strlen</span>(<span class="php-var">$dir</span>) &gt; <span class="php-num">155</span>) {
</span><span id="586" class="l"> <span class="php-comment">// we're still too large, let's use GNU longlink</span>
</span><span id="587" class="l"> <span class="php-var">$this</span>-&gt;writeRawFileHeader(<span class="php-quote">'././@LongLink'</span>, <span class="php-num">0</span>, <span class="php-num">0</span>, <span class="php-num">0</span>, <span class="php-var">$namelen</span>, <span class="php-num">0</span>, <span class="php-quote">'L'</span>);
</span><span id="588" class="l"> <span class="php-keyword1">for</span> (<span class="php-var">$s</span> = <span class="php-num">0</span>; <span class="php-var">$s</span> &lt; <span class="php-var">$namelen</span>; <span class="php-var">$s</span> += <span class="php-num">512</span>) {
</span><span id="589" class="l"> <span class="php-var">$this</span>-&gt;writebytes(<span class="php-keyword2">pack</span>(<span class="php-quote">&quot;a512&quot;</span>, <span class="php-keyword2">substr</span>(<span class="php-var">$name</span>, <span class="php-var">$s</span>, <span class="php-num">512</span>)));
</span><span id="590" class="l"> }
</span><span id="591" class="l"> <span class="php-var">$name</span> = <span class="php-keyword2">substr</span>(<span class="php-var">$name</span>, <span class="php-num">0</span>, <span class="php-num">100</span>); <span class="php-comment">// cut off name</span>
</span><span id="592" class="l"> } <span class="php-keyword1">else</span> {
</span><span id="593" class="l"> <span class="php-comment">// we're fine when splitting, use POSIX ustar</span>
</span><span id="594" class="l"> <span class="php-var">$prefix</span> = <span class="php-var">$dir</span>;
</span><span id="595" class="l"> <span class="php-var">$name</span> = <span class="php-var">$file</span>;
</span><span id="596" class="l"> }
</span><span id="597" class="l"> }
</span><span id="598" class="l">
</span><span id="599" class="l"> <span class="php-comment">// values are needed in octal</span>
</span><span id="600" class="l"> <span class="php-var">$uid</span> = <span class="php-keyword2">sprintf</span>(<span class="php-quote">&quot;%6s &quot;</span>, <span class="php-keyword2">decoct</span>(<span class="php-var">$uid</span>));
</span><span id="601" class="l"> <span class="php-var">$gid</span> = <span class="php-keyword2">sprintf</span>(<span class="php-quote">&quot;%6s &quot;</span>, <span class="php-keyword2">decoct</span>(<span class="php-var">$gid</span>));
</span><span id="602" class="l"> <span class="php-var">$perm</span> = <span class="php-keyword2">sprintf</span>(<span class="php-quote">&quot;%6s &quot;</span>, <span class="php-keyword2">decoct</span>(<span class="php-var">$perm</span>));
</span><span id="603" class="l"> <span class="php-var">$size</span> = self::numberEncode(<span class="php-var">$size</span>, <span class="php-num">12</span>);
</span><span id="604" class="l"> <span class="php-var">$mtime</span> = self::numberEncode(<span class="php-var">$size</span>, <span class="php-num">12</span>);
</span><span id="605" class="l">
</span><span id="606" class="l"> <span class="php-var">$data_first</span> = <span class="php-keyword2">pack</span>(<span class="php-quote">&quot;a100a8a8a8a12A12&quot;</span>, <span class="php-var">$name</span>, <span class="php-var">$perm</span>, <span class="php-var">$uid</span>, <span class="php-var">$gid</span>, <span class="php-var">$size</span>, <span class="php-var">$mtime</span>);
</span><span id="607" class="l"> <span class="php-var">$data_last</span> = <span class="php-keyword2">pack</span>(<span class="php-quote">&quot;a1a100a6a2a32a32a8a8a155a12&quot;</span>, <span class="php-var">$typeflag</span>, <span class="php-quote">''</span>, <span class="php-quote">'ustar'</span>, <span class="php-quote">''</span>, <span class="php-quote">''</span>, <span class="php-quote">''</span>, <span class="php-quote">''</span>, <span class="php-quote">''</span>, <span class="php-var">$prefix</span>, <span class="php-quote">&quot;&quot;</span>);
</span><span id="608" class="l">
</span><span id="609" class="l"> <span class="php-keyword1">for</span> (<span class="php-var">$i</span> = <span class="php-num">0</span>, <span class="php-var">$chks</span> = <span class="php-num">0</span>; <span class="php-var">$i</span> &lt; <span class="php-num">148</span>; <span class="php-var">$i</span>++) {
</span><span id="610" class="l"> <span class="php-var">$chks</span> += <span class="php-keyword2">ord</span>(<span class="php-var">$data_first</span>[<span class="php-var">$i</span>]);
</span><span id="611" class="l"> }
</span><span id="612" class="l">
</span><span id="613" class="l"> <span class="php-keyword1">for</span> (<span class="php-var">$i</span> = <span class="php-num">156</span>, <span class="php-var">$chks</span> += <span class="php-num">256</span>, <span class="php-var">$j</span> = <span class="php-num">0</span>; <span class="php-var">$i</span> &lt; <span class="php-num">512</span>; <span class="php-var">$i</span>++, <span class="php-var">$j</span>++) {
</span><span id="614" class="l"> <span class="php-var">$chks</span> += <span class="php-keyword2">ord</span>(<span class="php-var">$data_last</span>[<span class="php-var">$j</span>]);
</span><span id="615" class="l"> }
</span><span id="616" class="l">
</span><span id="617" class="l"> <span class="php-var">$this</span>-&gt;writebytes(<span class="php-var">$data_first</span>);
</span><span id="618" class="l">
</span><span id="619" class="l"> <span class="php-var">$chks</span> = <span class="php-keyword2">pack</span>(<span class="php-quote">&quot;a8&quot;</span>, <span class="php-keyword2">sprintf</span>(<span class="php-quote">&quot;%6s &quot;</span>, <span class="php-keyword2">decoct</span>(<span class="php-var">$chks</span>)));
</span><span id="620" class="l"> <span class="php-var">$this</span>-&gt;writebytes(<span class="php-var">$chks</span>.<span class="php-var">$data_last</span>);
</span><span id="621" class="l"> }
</span><span id="622" class="l">
</span><span id="623" class="l"> <span class="php-comment">/**
</span></span><span id="624" class="l"><span class="php-comment"> * Decode the given tar file header
</span></span><span id="625" class="l"><span class="php-comment"> *
</span></span><span id="626" class="l"><span class="php-comment"> * @param string $block a 512 byte block containing the header data
</span></span><span id="627" class="l"><span class="php-comment"> * @return array|false returns false when this was a null block
</span></span><span id="628" class="l"><span class="php-comment"> * @throws ArchiveCorruptedException
</span></span><span id="629" class="l"><span class="php-comment"> */</span>
</span><span id="630" class="l"> <span class="php-keyword1">protected</span> <span class="php-keyword1">function</span> parseHeader(<span class="php-var">$block</span>)
</span><span id="631" class="l"> {
</span><span id="632" class="l"> <span class="php-keyword1">if</span> (!<span class="php-var">$block</span> || <span class="php-keyword2">strlen</span>(<span class="php-var">$block</span>) != <span class="php-num">512</span>) {
</span><span id="633" class="l"> <span class="php-keyword1">throw</span> <span class="php-keyword1">new</span> ArchiveCorruptedException(<span class="php-quote">'Unexpected length of header'</span>);
</span><span id="634" class="l"> }
</span><span id="635" class="l">
</span><span id="636" class="l"> <span class="php-comment">// null byte blocks are ignored</span>
</span><span id="637" class="l"> <span class="php-keyword1">if</span>(<span class="php-keyword2">trim</span>(<span class="php-var">$block</span>) === <span class="php-quote">''</span>) <span class="php-keyword1">return</span> <span class="php-keyword1">false</span>;
</span><span id="638" class="l">
</span><span id="639" class="l"> <span class="php-keyword1">for</span> (<span class="php-var">$i</span> = <span class="php-num">0</span>, <span class="php-var">$chks</span> = <span class="php-num">0</span>; <span class="php-var">$i</span> &lt; <span class="php-num">148</span>; <span class="php-var">$i</span>++) {
</span><span id="640" class="l"> <span class="php-var">$chks</span> += <span class="php-keyword2">ord</span>(<span class="php-var">$block</span>[<span class="php-var">$i</span>]);
</span><span id="641" class="l"> }
</span><span id="642" class="l">
</span><span id="643" class="l"> <span class="php-keyword1">for</span> (<span class="php-var">$i</span> = <span class="php-num">156</span>, <span class="php-var">$chks</span> += <span class="php-num">256</span>; <span class="php-var">$i</span> &lt; <span class="php-num">512</span>; <span class="php-var">$i</span>++) {
</span><span id="644" class="l"> <span class="php-var">$chks</span> += <span class="php-keyword2">ord</span>(<span class="php-var">$block</span>[<span class="php-var">$i</span>]);
</span><span id="645" class="l"> }
</span><span id="646" class="l">
</span><span id="647" class="l"> <span class="php-var">$header</span> = @<span class="php-keyword2">unpack</span>(
</span><span id="648" class="l"> <span class="php-quote">&quot;a100filename/a8perm/a8uid/a8gid/a12size/a12mtime/a8checksum/a1typeflag/a100link/a6magic/a2version/a32uname/a32gname/a8devmajor/a8devminor/a155prefix&quot;</span>,
</span><span id="649" class="l"> <span class="php-var">$block</span>
</span><span id="650" class="l"> );
</span><span id="651" class="l"> <span class="php-keyword1">if</span> (!<span class="php-var">$header</span>) {
</span><span id="652" class="l"> <span class="php-keyword1">throw</span> <span class="php-keyword1">new</span> ArchiveCorruptedException(<span class="php-quote">'Failed to parse header'</span>);
</span><span id="653" class="l"> }
</span><span id="654" class="l">
</span><span id="655" class="l"> <span class="php-var">$return</span>[<span class="php-quote">'checksum'</span>] = <span class="php-keyword2">OctDec</span>(<span class="php-keyword2">trim</span>(<span class="php-var">$header</span>[<span class="php-quote">'checksum'</span>]));
</span><span id="656" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$return</span>[<span class="php-quote">'checksum'</span>] != <span class="php-var">$chks</span>) {
</span><span id="657" class="l"> <span class="php-keyword1">throw</span> <span class="php-keyword1">new</span> ArchiveCorruptedException(<span class="php-quote">'Header does not match its checksum'</span>);
</span><span id="658" class="l"> }
</span><span id="659" class="l">
</span><span id="660" class="l"> <span class="php-var">$return</span>[<span class="php-quote">'filename'</span>] = <span class="php-keyword2">trim</span>(<span class="php-var">$header</span>[<span class="php-quote">'filename'</span>]);
</span><span id="661" class="l"> <span class="php-var">$return</span>[<span class="php-quote">'perm'</span>] = <span class="php-keyword2">OctDec</span>(<span class="php-keyword2">trim</span>(<span class="php-var">$header</span>[<span class="php-quote">'perm'</span>]));
</span><span id="662" class="l"> <span class="php-var">$return</span>[<span class="php-quote">'uid'</span>] = <span class="php-keyword2">OctDec</span>(<span class="php-keyword2">trim</span>(<span class="php-var">$header</span>[<span class="php-quote">'uid'</span>]));
</span><span id="663" class="l"> <span class="php-var">$return</span>[<span class="php-quote">'gid'</span>] = <span class="php-keyword2">OctDec</span>(<span class="php-keyword2">trim</span>(<span class="php-var">$header</span>[<span class="php-quote">'gid'</span>]));
</span><span id="664" class="l"> <span class="php-var">$return</span>[<span class="php-quote">'size'</span>] = self::numberDecode(<span class="php-var">$header</span>[<span class="php-quote">'size'</span>]);
</span><span id="665" class="l"> <span class="php-var">$return</span>[<span class="php-quote">'mtime'</span>] = self::numberDecode(<span class="php-var">$header</span>[<span class="php-quote">'mtime'</span>]);
</span><span id="666" class="l"> <span class="php-var">$return</span>[<span class="php-quote">'typeflag'</span>] = <span class="php-var">$header</span>[<span class="php-quote">'typeflag'</span>];
</span><span id="667" class="l"> <span class="php-var">$return</span>[<span class="php-quote">'link'</span>] = <span class="php-keyword2">trim</span>(<span class="php-var">$header</span>[<span class="php-quote">'link'</span>]);
</span><span id="668" class="l"> <span class="php-var">$return</span>[<span class="php-quote">'uname'</span>] = <span class="php-keyword2">trim</span>(<span class="php-var">$header</span>[<span class="php-quote">'uname'</span>]);
</span><span id="669" class="l"> <span class="php-var">$return</span>[<span class="php-quote">'gname'</span>] = <span class="php-keyword2">trim</span>(<span class="php-var">$header</span>[<span class="php-quote">'gname'</span>]);
</span><span id="670" class="l">
</span><span id="671" class="l"> <span class="php-comment">// Handle ustar Posix compliant path prefixes</span>
</span><span id="672" class="l"> <span class="php-keyword1">if</span> (<span class="php-keyword2">trim</span>(<span class="php-var">$header</span>[<span class="php-quote">'prefix'</span>])) {
</span><span id="673" class="l"> <span class="php-var">$return</span>[<span class="php-quote">'filename'</span>] = <span class="php-keyword2">trim</span>(<span class="php-var">$header</span>[<span class="php-quote">'prefix'</span>]).<span class="php-quote">'/'</span>.<span class="php-var">$return</span>[<span class="php-quote">'filename'</span>];
</span><span id="674" class="l"> }
</span><span id="675" class="l">
</span><span id="676" class="l"> <span class="php-comment">// Handle Long-Link entries from GNU Tar</span>
</span><span id="677" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$return</span>[<span class="php-quote">'typeflag'</span>] == <span class="php-quote">'L'</span>) {
</span><span id="678" class="l"> <span class="php-comment">// following data block(s) is the filename</span>
</span><span id="679" class="l"> <span class="php-var">$filename</span> = <span class="php-keyword2">trim</span>(<span class="php-var">$this</span>-&gt;readbytes(<span class="php-keyword2">ceil</span>(<span class="php-var">$return</span>[<span class="php-quote">'size'</span>] / <span class="php-num">512</span>) * <span class="php-num">512</span>));
</span><span id="680" class="l"> <span class="php-comment">// next block is the real header</span>
</span><span id="681" class="l"> <span class="php-var">$block</span> = <span class="php-var">$this</span>-&gt;readbytes(<span class="php-num">512</span>);
</span><span id="682" class="l"> <span class="php-var">$return</span> = <span class="php-var">$this</span>-&gt;parseHeader(<span class="php-var">$block</span>);
</span><span id="683" class="l"> <span class="php-comment">// overwrite the filename</span>
</span><span id="684" class="l"> <span class="php-var">$return</span>[<span class="php-quote">'filename'</span>] = <span class="php-var">$filename</span>;
</span><span id="685" class="l"> }
</span><span id="686" class="l">
</span><span id="687" class="l"> <span class="php-keyword1">return</span> <span class="php-var">$return</span>;
</span><span id="688" class="l"> }
</span><span id="689" class="l">
</span><span id="690" class="l"> <span class="php-comment">/**
</span></span><span id="691" class="l"><span class="php-comment"> * Creates a FileInfo object from the given parsed header
</span></span><span id="692" class="l"><span class="php-comment"> *
</span></span><span id="693" class="l"><span class="php-comment"> * @param $header
</span></span><span id="694" class="l"><span class="php-comment"> * @return FileInfo
</span></span><span id="695" class="l"><span class="php-comment"> */</span>
</span><span id="696" class="l"> <span class="php-keyword1">protected</span> <span class="php-keyword1">function</span> header2fileinfo(<span class="php-var">$header</span>)
</span><span id="697" class="l"> {
</span><span id="698" class="l"> <span class="php-var">$fileinfo</span> = <span class="php-keyword1">new</span> FileInfo();
</span><span id="699" class="l"> <span class="php-var">$fileinfo</span>-&gt;setPath(<span class="php-var">$header</span>[<span class="php-quote">'filename'</span>]);
</span><span id="700" class="l"> <span class="php-var">$fileinfo</span>-&gt;setMode(<span class="php-var">$header</span>[<span class="php-quote">'perm'</span>]);
</span><span id="701" class="l"> <span class="php-var">$fileinfo</span>-&gt;setUid(<span class="php-var">$header</span>[<span class="php-quote">'uid'</span>]);
</span><span id="702" class="l"> <span class="php-var">$fileinfo</span>-&gt;setGid(<span class="php-var">$header</span>[<span class="php-quote">'gid'</span>]);
</span><span id="703" class="l"> <span class="php-var">$fileinfo</span>-&gt;setSize(<span class="php-var">$header</span>[<span class="php-quote">'size'</span>]);
</span><span id="704" class="l"> <span class="php-var">$fileinfo</span>-&gt;setMtime(<span class="php-var">$header</span>[<span class="php-quote">'mtime'</span>]);
</span><span id="705" class="l"> <span class="php-var">$fileinfo</span>-&gt;setOwner(<span class="php-var">$header</span>[<span class="php-quote">'uname'</span>]);
</span><span id="706" class="l"> <span class="php-var">$fileinfo</span>-&gt;setGroup(<span class="php-var">$header</span>[<span class="php-quote">'gname'</span>]);
</span><span id="707" class="l"> <span class="php-var">$fileinfo</span>-&gt;setIsdir((bool) <span class="php-var">$header</span>[<span class="php-quote">'typeflag'</span>]);
</span><span id="708" class="l">
</span><span id="709" class="l"> <span class="php-keyword1">return</span> <span class="php-var">$fileinfo</span>;
</span><span id="710" class="l"> }
</span><span id="711" class="l">
</span><span id="712" class="l"> <span class="php-comment">/**
</span></span><span id="713" class="l"><span class="php-comment"> * Checks if the given compression type is available and throws an exception if not
</span></span><span id="714" class="l"><span class="php-comment"> *
</span></span><span id="715" class="l"><span class="php-comment"> * @param $comptype
</span></span><span id="716" class="l"><span class="php-comment"> * @throws ArchiveIllegalCompressionException
</span></span><span id="717" class="l"><span class="php-comment"> */</span>
</span><span id="718" class="l"> <span class="php-keyword1">protected</span> <span class="php-keyword1">function</span> compressioncheck(<span class="php-var">$comptype</span>)
</span><span id="719" class="l"> {
</span><span id="720" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$comptype</span> === Archive::COMPRESS_GZIP &amp;&amp; !<span class="php-keyword2">function_exists</span>(<span class="php-quote">'gzopen'</span>)) {
</span><span id="721" class="l"> <span class="php-keyword1">throw</span> <span class="php-keyword1">new</span> ArchiveIllegalCompressionException(<span class="php-quote">'No gzip support available'</span>);
</span><span id="722" class="l"> }
</span><span id="723" class="l">
</span><span id="724" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$comptype</span> === Archive::COMPRESS_BZIP &amp;&amp; !<span class="php-keyword2">function_exists</span>(<span class="php-quote">'bzopen'</span>)) {
</span><span id="725" class="l"> <span class="php-keyword1">throw</span> <span class="php-keyword1">new</span> ArchiveIllegalCompressionException(<span class="php-quote">'No bzip2 support available'</span>);
</span><span id="726" class="l"> }
</span><span id="727" class="l"> }
</span><span id="728" class="l">
</span><span id="729" class="l"> <span class="php-comment">/**
</span></span><span id="730" class="l"><span class="php-comment"> * Guesses the wanted compression from the given file
</span></span><span id="731" class="l"><span class="php-comment"> *
</span></span><span id="732" class="l"><span class="php-comment"> * Uses magic bytes for existing files, the file extension otherwise
</span></span><span id="733" class="l"><span class="php-comment"> *
</span></span><span id="734" class="l"><span class="php-comment"> * You don't need to call this yourself. It's used when you pass Archive::COMPRESS_AUTO somewhere
</span></span><span id="735" class="l"><span class="php-comment"> *
</span></span><span id="736" class="l"><span class="php-comment"> * @param string $file
</span></span><span id="737" class="l"><span class="php-comment"> * @return int
</span></span><span id="738" class="l"><span class="php-comment"> */</span>
</span><span id="739" class="l"> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <span class="php-keyword2">filetype</span>(<span class="php-var">$file</span>)
</span><span id="740" class="l"> {
</span><span id="741" class="l"> <span class="php-comment">// for existing files, try to read the magic bytes</span>
</span><span id="742" class="l"> <span class="php-keyword1">if</span>(<span class="php-keyword2">file_exists</span>(<span class="php-var">$file</span>) &amp;&amp; <span class="php-keyword2">is_readable</span>(<span class="php-var">$file</span>) &amp;&amp; <span class="php-keyword2">filesize</span>(<span class="php-var">$file</span>) &gt; <span class="php-num">5</span>) {
</span><span id="743" class="l"> <span class="php-var">$fh</span> = @<span class="php-keyword2">fopen</span>(<span class="php-var">$file</span>, <span class="php-quote">'rb'</span>);
</span><span id="744" class="l"> <span class="php-keyword1">if</span>(!<span class="php-var">$fh</span>) <span class="php-keyword1">return</span> <span class="php-keyword1">false</span>;
</span><span id="745" class="l"> <span class="php-var">$magic</span> = <span class="php-keyword2">fread</span>(<span class="php-var">$fh</span>, <span class="php-num">5</span>);
</span><span id="746" class="l"> <span class="php-keyword2">fclose</span>(<span class="php-var">$fh</span>);
</span><span id="747" class="l">
</span><span id="748" class="l"> <span class="php-keyword1">if</span>(<span class="php-keyword2">strpos</span>(<span class="php-var">$magic</span>, <span class="php-quote">&quot;\x42\x5a&quot;</span>) === <span class="php-num">0</span>) <span class="php-keyword1">return</span> Archive::COMPRESS_BZIP;
</span><span id="749" class="l"> <span class="php-keyword1">if</span>(<span class="php-keyword2">strpos</span>(<span class="php-var">$magic</span>, <span class="php-quote">&quot;\x1f\x8b&quot;</span>) === <span class="php-num">0</span>) <span class="php-keyword1">return</span> Archive::COMPRESS_GZIP;
</span><span id="750" class="l"> }
</span><span id="751" class="l">
</span><span id="752" class="l"> <span class="php-comment">// otherwise rely on file name</span>
</span><span id="753" class="l"> <span class="php-var">$file</span> = <span class="php-keyword2">strtolower</span>(<span class="php-var">$file</span>);
</span><span id="754" class="l"> <span class="php-keyword1">if</span> (<span class="php-keyword2">substr</span>(<span class="php-var">$file</span>, -<span class="php-num">3</span>) == <span class="php-quote">'.gz'</span> || <span class="php-keyword2">substr</span>(<span class="php-var">$file</span>, -<span class="php-num">4</span>) == <span class="php-quote">'.tgz'</span>) {
</span><span id="755" class="l"> <span class="php-keyword1">return</span> Archive::COMPRESS_GZIP;
</span><span id="756" class="l"> } <span class="php-keyword1">elseif</span> (<span class="php-keyword2">substr</span>(<span class="php-var">$file</span>, -<span class="php-num">4</span>) == <span class="php-quote">'.bz2'</span> || <span class="php-keyword2">substr</span>(<span class="php-var">$file</span>, -<span class="php-num">4</span>) == <span class="php-quote">'.tbz'</span>) {
</span><span id="757" class="l"> <span class="php-keyword1">return</span> Archive::COMPRESS_BZIP;
</span><span id="758" class="l"> }
</span><span id="759" class="l">
</span><span id="760" class="l"> <span class="php-keyword1">return</span> Archive::COMPRESS_NONE;
</span><span id="761" class="l"> }
</span><span id="762" class="l">
</span><span id="763" class="l"> <span class="php-comment">/**
</span></span><span id="764" class="l"><span class="php-comment"> * Decodes numeric values according to the
</span></span><span id="765" class="l"><span class="php-comment"> * https://www.gnu.org/software/tar/manual/html_node/Extensions.html#Extensions
</span></span><span id="766" class="l"><span class="php-comment"> * (basically with support for big numbers)
</span></span><span id="767" class="l"><span class="php-comment"> *
</span></span><span id="768" class="l"><span class="php-comment"> * @param string $field
</span></span><span id="769" class="l"><span class="php-comment"> * $return int
</span></span><span id="770" class="l"><span class="php-comment"> */</span>
</span><span id="771" class="l"> <span class="php-keyword1">static</span> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> numberDecode(<span class="php-var">$field</span>)
</span><span id="772" class="l"> {
</span><span id="773" class="l"> <span class="php-var">$firstByte</span> = <span class="php-keyword2">ord</span>(<span class="php-keyword2">substr</span>(<span class="php-var">$field</span>, <span class="php-num">0</span>, <span class="php-num">1</span>));
</span><span id="774" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$firstByte</span> === <span class="php-num">255</span>) {
</span><span id="775" class="l"> <span class="php-var">$value</span> = -<span class="php-num">1</span> &lt;&lt; (<span class="php-num">8</span> * <span class="php-keyword2">strlen</span>(<span class="php-var">$field</span>));
</span><span id="776" class="l"> <span class="php-var">$shift</span> = <span class="php-num">0</span>;
</span><span id="777" class="l"> <span class="php-keyword1">for</span> (<span class="php-var">$i</span> = <span class="php-keyword2">strlen</span>(<span class="php-var">$field</span>) - <span class="php-num">1</span>; <span class="php-var">$i</span> &gt;= <span class="php-num">0</span>; <span class="php-var">$i</span>--) {
</span><span id="778" class="l"> <span class="php-var">$value</span> += <span class="php-keyword2">ord</span>(<span class="php-keyword2">substr</span>(<span class="php-var">$field</span>, <span class="php-var">$i</span>, <span class="php-num">1</span>)) &lt;&lt; <span class="php-var">$shift</span>;
</span><span id="779" class="l"> <span class="php-var">$shift</span> += <span class="php-num">8</span>;
</span><span id="780" class="l"> }
</span><span id="781" class="l"> } <span class="php-keyword1">elseif</span> (<span class="php-var">$firstByte</span> === <span class="php-num">128</span>) {
</span><span id="782" class="l"> <span class="php-var">$value</span> = <span class="php-num">0</span>;
</span><span id="783" class="l"> <span class="php-var">$shift</span> = <span class="php-num">0</span>;
</span><span id="784" class="l"> <span class="php-keyword1">for</span> (<span class="php-var">$i</span> = <span class="php-keyword2">strlen</span>(<span class="php-var">$field</span>) - <span class="php-num">1</span>; <span class="php-var">$i</span> &gt; <span class="php-num">0</span>; <span class="php-var">$i</span>--) {
</span><span id="785" class="l"> <span class="php-var">$value</span> += <span class="php-keyword2">ord</span>(<span class="php-keyword2">substr</span>(<span class="php-var">$field</span>, <span class="php-var">$i</span>, <span class="php-num">1</span>)) &lt;&lt; <span class="php-var">$shift</span>;
</span><span id="786" class="l"> <span class="php-var">$shift</span> += <span class="php-num">8</span>;
</span><span id="787" class="l"> }
</span><span id="788" class="l"> } <span class="php-keyword1">else</span> {
</span><span id="789" class="l"> <span class="php-var">$value</span> = <span class="php-keyword2">octdec</span>(<span class="php-keyword2">trim</span>(<span class="php-var">$field</span>));
</span><span id="790" class="l"> }
</span><span id="791" class="l"> <span class="php-keyword1">return</span> <span class="php-var">$value</span>;
</span><span id="792" class="l"> }
</span><span id="793" class="l">
</span><span id="794" class="l"> <span class="php-comment">/**
</span></span><span id="795" class="l"><span class="php-comment"> * Encodes numeric values according to the
</span></span><span id="796" class="l"><span class="php-comment"> * https://www.gnu.org/software/tar/manual/html_node/Extensions.html#Extensions
</span></span><span id="797" class="l"><span class="php-comment"> * (basically with support for big numbers)
</span></span><span id="798" class="l"><span class="php-comment"> *
</span></span><span id="799" class="l"><span class="php-comment"> * @param int $value
</span></span><span id="800" class="l"><span class="php-comment"> * @param int $length field length
</span></span><span id="801" class="l"><span class="php-comment"> * @return string
</span></span><span id="802" class="l"><span class="php-comment"> */</span>
</span><span id="803" class="l"> <span class="php-keyword1">static</span> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> numberEncode(<span class="php-var">$value</span>, <span class="php-var">$length</span>)
</span><span id="804" class="l"> {
</span><span id="805" class="l"> <span class="php-comment">// old implementations leave last byte empty</span>
</span><span id="806" class="l"> <span class="php-comment">// octal encoding encodes three bits per byte</span>
</span><span id="807" class="l"> <span class="php-var">$maxValue</span> = <span class="php-num">1</span> &lt;&lt; ((<span class="php-var">$length</span> - <span class="php-num">1</span>) * <span class="php-num">3</span>);
</span><span id="808" class="l"> <span class="php-keyword1">if</span> (<span class="php-var">$value</span> &lt; <span class="php-num">0</span>) {
</span><span id="809" class="l"> <span class="php-comment">// PHP already stores integers as 2's complement</span>
</span><span id="810" class="l"> <span class="php-var">$value</span> = <span class="php-keyword2">pack</span>(PHP_INT_SIZE === <span class="php-num">8</span> ? <span class="php-quote">'J'</span> : <span class="php-quote">'N'</span>, (int) <span class="php-var">$value</span>);
</span><span id="811" class="l"> <span class="php-var">$encoded</span> = <span class="php-keyword2">str_repeat</span>(<span class="php-keyword2">chr</span>(<span class="php-num">255</span>), <span class="php-keyword2">max</span>(<span class="php-num">1</span>, <span class="php-var">$length</span> - PHP_INT_SIZE));
</span><span id="812" class="l"> <span class="php-var">$encoded</span> .= <span class="php-keyword2">substr</span>(<span class="php-var">$value</span>, <span class="php-keyword2">max</span>(<span class="php-num">0</span>, PHP_INT_SIZE - <span class="php-var">$length</span> + <span class="php-num">1</span>));
</span><span id="813" class="l"> } <span class="php-keyword1">elseif</span> (<span class="php-var">$value</span> &gt;= <span class="php-var">$maxValue</span>) {
</span><span id="814" class="l"> <span class="php-var">$value</span> = <span class="php-keyword2">pack</span>(PHP_INT_SIZE === <span class="php-num">8</span> ? <span class="php-quote">'J'</span> : <span class="php-quote">'N'</span>, (int) <span class="php-var">$value</span>);
</span><span id="815" class="l"> <span class="php-var">$encoded</span> = <span class="php-keyword2">chr</span>(<span class="php-num">128</span>) . <span class="php-keyword2">str_repeat</span>(<span class="php-keyword2">chr</span>(<span class="php-num">0</span>), <span class="php-keyword2">max</span>(<span class="php-num">0</span>, <span class="php-var">$length</span> - PHP_INT_SIZE - <span class="php-num">1</span>));
</span><span id="816" class="l"> <span class="php-var">$encoded</span> .= <span class="php-keyword2">substr</span>(<span class="php-var">$value</span>, <span class="php-keyword2">max</span>(<span class="php-num">0</span>, PHP_INT_SIZE - <span class="php-var">$length</span> + <span class="php-num">1</span>));
</span><span id="817" class="l"> } <span class="php-keyword1">else</span> {
</span><span id="818" class="l"> <span class="php-var">$encoded</span> = <span class="php-keyword2">sprintf</span>(<span class="php-quote">&quot;%&quot;</span> . (<span class="php-var">$length</span> - <span class="php-num">1</span>) . <span class="php-quote">&quot;s &quot;</span>, <span class="php-keyword2">decoct</span>(<span class="php-var">$value</span>));
</span><span id="819" class="l"> }
</span><span id="820" class="l"> <span class="php-keyword1">return</span> <span class="php-var">$encoded</span>;
</span><span id="821" class="l"> }
</span><span id="822" class="l">}
</span><span id="823" class="l">
</span><span id="824" class="l"></span></code></pre>
<div id="footer">
API documentation generated by <a href="http://apigen.org">ApiGen</a>
</div>
</div>
</div>
<script src="resources/combined.js?58699d70ee1015ed63e509c64f4dd9d3b29ddbbe"></script>
<script src="elementlist.js?d1556c44b5531910445709dcbedf0d7a38d1a058"></script>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink