phar.webphar.html
来自「php的帮助文档,涉及到PHP的案例和基本语法,以及实际应用内容」· HTML 代码 · 共 212 行
HTML
212 行
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html> <head> <title>mapPhar for web-based phars. front controller for web applications</title> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> </head> <body><div style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="class.Phar.html">Phar</a></div> <div class="next" style="text-align: right; float: right;"><a href="class.PharData.html">PharData</a></div> <div class="up"><a href="class.Phar.html">Phar</a></div> <div class="home"><a href="index.html">PHP Manual</a></div></div><hr /><div id="phar.webphar" class="refentry"> <div class="refnamediv"> <h1 class="refname">Phar::webPhar</h1> <p class="verinfo">(No version information available, might be only in CVS)</p><p class="refpurpose"><span class="refname">Phar::webPhar</span> — <span class="dc-title">mapPhar for web-based phars. front controller for web applications</span></p> </div> <div class="refsect1 description"> <h3 class="title">Description</h3> <div class="methodsynopsis dc-description"> <span class="type"><span class="type void">void</span></span> <span class="methodname"><b><b>Phar::webPhar</b></b></span> ( <span class="methodparam"><span class="type">string</span> <tt class="parameter">$alias</tt></span> , <span class="methodparam"><span class="type">string</span> <tt class="parameter">$index</tt></span> , <span class="methodparam"><span class="type">string</span> <tt class="parameter">$f404</tt></span> , <span class="methodparam"><span class="type">array</span> <tt class="parameter">$mimetypes</tt></span> , <span class="methodparam"><span class="type">array</span> <tt class="parameter">$rewrites</tt></span> )</div> <p class="para rdfs-comment"> <a href="phar.mapphar.html" class="function">Phar::mapPhar()</a> for web-based phars. This method parses <var class="varname"><a href="reserved.variables.server.html" class="classname">$_SERVER['REQUEST_URI']</a></var> and routes a request from a web browser to an internal file within the phar archive. In essence, it simulates a web server, routing requests to the correct file, echoing the correct headers and parsing PHP files as needed. This powerful method is part of what makes it easy to convert an existing PHP application into a phar archive. Combined with <a href="phar.mungserver.html" class="function">Phar::mungServer()</a> and <a href="phar.interceptfilefuncs.html" class="function">Phar::interceptFileFuncs()</a>, any web application can be used unmodified from a phar archive. </p> <p class="para"> <b>Phar::webPhar()</b> should only be called from the stub of a phar archive (see <a href="phar.fileformat.stub.html" class="link">here</a> for more information on what a stub is). </p> </div> <div class="refsect1 parameters"> <h3 class="title">Parameters</h3> <p class="para"> <dl> <dt> <span class="term"><i><tt class="parameter">alias</tt></i></span> <dd> <p class="para"> The alias that can be used in <i>phar://</i> URLs to refer to this archive, rather than its full path. </p> </dd> </dt> <dt> <span class="term"><i><tt class="parameter">index</tt></i></span> <dd> <p class="para"> The location within the phar of the directory index, defaults to <i>index.php</i>. </p> </dd> </dt> <dt> <span class="term"><i><tt class="parameter">f404</tt></i></span> <dd> <p class="para"> The location of the script to run when a file is not found. This script should output the proper HTTP 404 headers. </p> </dd> </dt> <dt> <span class="term"><i><tt class="parameter">mimetypes</tt></i></span> <dd> <p class="para"> An array mapping additional file extensions to MIME type. By default, these extensions are mapped to these mime types: <div class="example-contents"> <div class="phpcode"><code><span style="color: #000000">$mimes = array(<br /> 'phps' => 2, // pass to highlight_file()<br /> 'c' => 'text/plain',<br /> 'cc' => 'text/plain',<br /> 'cpp' => 'text/plain',<br /> 'c++' => 'text/plain',<br /> 'dtd' => 'text/plain',<br /> 'h' => 'text/plain',<br /> 'log' => 'text/plain',<br /> 'rng' => 'text/plain',<br /> 'txt' => 'text/plain',<br /> 'xsd' => 'text/plain',<br /> 'php' => 1, // parse as PHP<br /> 'inc' => 1, // parse as PHP<br /> 'avi' => 'video/avi',<br /> 'bmp' => 'image/bmp',<br /> 'css' => 'text/css',<br /> 'gif' => 'image/gif',<br /> 'htm' => 'text/html',<br /> 'html' => 'text/html',<br /> 'htmls' => 'text/html',<br /> 'ico' => 'image/x-ico',<br /> 'jpe' => 'image/jpeg',<br /> 'jpg' => 'image/jpeg',<br /> 'jpeg' => 'image/jpeg',<br /> 'js' => 'application/x-javascript',<br /> 'midi' => 'audio/midi',<br /> 'mid' => 'audio/midi',<br /> 'mod' => 'audio/mod',<br /> 'mov' => 'movie/quicktime',<br /> 'mp3' => 'audio/mp3',<br /> 'mpg' => 'video/mpeg',<br /> 'mpeg' => 'video/mpeg',<br /> 'pdf' => 'application/pdf',<br /> 'png' => 'image/png',<br /> 'swf' => 'application/shockwave-flash',<br /> 'tif' => 'image/tiff',<br /> 'tiff' => 'image/tiff',<br /> 'wav' => 'audio/wav',<br /> 'xbm' => 'image/xbm',<br /> 'xml' => 'text/xml',<br />);</span></code></div> </div> </p> </dd> </dt> <dt> <span class="term"><i><tt class="parameter">rewrites</tt></i></span> <dd> <p class="para"> An array mapping URI to internal file, simulating mod_rewrite of apache. For example: <div class="example-contents"> <div class="phpcode"><code><span style="color: #000000">array(<br /> 'myinfo' => 'myinfo.php'<br />);</span></code></div> </div> would route calls to <i>http://<host>/myphar.phar/myinfo</i> to the file <i>phar:///path/to/myphar.phar/myinfo.php</i>, preserving GET/POST. This does not quite work like mod_rewrite in that it would not match <i>http://<host>/myphar.phar/myinfo/another</i>. </p> </dd> </dt> </dl> </p> </div> <div class="refsect1 returnvalues"> <h3 class="title">Return Values</h3> <p class="para"> No return values </p> </div> <div class="refsect1 errors"> <h3 class="title">Errors/Exceptions</h3> <p class="para"> Throws <a href="class.PharException.html" class="classname">PharException</a> when unable to open the internal file to output, or if called from a non-stub. If an invalid array value is passed into <i><tt class="parameter">mimetypes</tt></i> or to <i><tt class="parameter">rewrites</tt></i>, then <b class="classname">UnexpectedValueException</b> is thrown. </p> </div> <div class="refsect1 examples"> <h3 class="title">Examples</h3> <p class="para"> <div class="example"> <p><b>Example #1 A <b>Phar::webPhar()</b> example</b></p> <div class="example-contents"><p> With the example below, the created phar will display <i>Hello World</i> if one browses to <i>/myphar.phar/index.php</i> or to <i>/myphar.phar</i>, and will display the source of <i>index.phps</i> if one browses to <i>/myphar.phar/index.phps</i>. </p></div> <div class="example-contents"><div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB"><?php<br /></span><span style="color: #FF8000">// creating the phar archive:<br /></span><span style="color: #007700">try {<br /> </span><span style="color: #0000BB">$phar </span><span style="color: #007700">= new </span><span style="color: #0000BB">Phar</span><span style="color: #007700">(</span><span style="color: #DD0000">'myphar.phar'</span><span style="color: #007700">);<br /> </span><span style="color: #0000BB">$phar</span><span style="color: #007700">[</span><span style="color: #DD0000">'index.php'</span><span style="color: #007700">] = </span><span style="color: #DD0000">'<?php echo "Hello World"; ?>'</span><span style="color: #007700">;<br /> </span><span style="color: #0000BB">$phar</span><span style="color: #007700">[</span><span style="color: #DD0000">'index.phps'</span><span style="color: #007700">] = </span><span style="color: #DD0000">'<?php echo "Hello World"; ?>'</span><span style="color: #007700">;<br /> </span><span style="color: #0000BB">$phar</span><span style="color: #007700">-></span><span style="color: #0000BB">setStub</span><span style="color: #007700">(</span><span style="color: #DD0000">'<?php<br />Phar::webPhar();<br />__HALT_COMPILER(); ?>'</span><span style="color: #007700">);<br />} catch (</span><span style="color: #0000BB">Exception $e</span><span style="color: #007700">) {<br /> </span><span style="color: #FF8000">// handle error here<br /></span><span style="color: #007700">}<br /></span><span style="color: #0000BB">?></span></span></code></div> </div> </div> </p> </div> <div class="refsect1 seealso"> <h3 class="title">See Also</h3> <p class="para"> <ul class="simplelist"> <li class="member"><a href="phar.mungserver.html" class="function" rel="rdfs-seeAlso">Phar::mungServer()</a></li> <li class="member"><a href="phar.interceptfilefuncs.html" class="function" rel="rdfs-seeAlso">Phar::interceptFileFuncs()</a></li> </ul> </p> </div></div><hr /><div style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="class.Phar.html">Phar</a></div> <div class="next" style="text-align: right; float: right;"><a href="class.PharData.html">PharData</a></div> <div class="up"><a href="class.Phar.html">Phar</a></div> <div class="home"><a href="index.html">PHP Manual</a></div></div></body></html>⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?