[prev in list] [next in list] [prev in thread] [next in thread] 

List:       php-doc-cvs
Subject:    [DOC-CVS] =?utf-8?q?svn:_/phpdoc/en/trunk/reference/xsl/_constants.xml_ini.xml_xsltprocessor/getsecu
From:       Christoph_Michael_Becker <cmb () php ! net>
Date:       2015-06-15 13:26:16
Message-ID: svn-cmb-1434374776-336970-1157776801 () svn ! php ! net
[Download RAW message or body]

cmb                                      Mon, 15 Jun 2015 13:26:16 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=336970

Log:
documented xsl.security_prefs and related functions and constants (fixes #61233)

Bug: https://bugs.php.net/61233 (Assigned) xsl.security_prefs is not documented
      
Changed paths:
    U   phpdoc/en/trunk/reference/xsl/constants.xml
    A   phpdoc/en/trunk/reference/xsl/ini.xml
    U   phpdoc/en/trunk/reference/xsl/xsltprocessor/getsecurityprefs.xml
    U   phpdoc/en/trunk/reference/xsl/xsltprocessor/setsecurityprefs.xml

Modified: phpdoc/en/trunk/reference/xsl/constants.xml
===================================================================
--- phpdoc/en/trunk/reference/xsl/constants.xml	2015-06-15 11:57:15 UTC (rev 336969)
+++ phpdoc/en/trunk/reference/xsl/constants.xml	2015-06-15 13:26:16 UTC (rev 336970)
@@ -95,6 +95,7 @@
    </term>
    <listitem>
     <simpara>
+     Disallows reading files.
     </simpara>
    </listitem>
   </varlistentry>
@@ -105,6 +106,7 @@
    </term>
    <listitem>
     <simpara>
+     Disallows writing files.
     </simpara>
    </listitem>
   </varlistentry>
@@ -115,6 +117,7 @@
    </term>
    <listitem>
     <simpara>
+     Disallows creating directories.
     </simpara>
    </listitem>
   </varlistentry>
@@ -125,6 +128,7 @@
    </term>
    <listitem>
     <simpara>
+     Disallows reading network files.
     </simpara>
    </listitem>
   </varlistentry>
@@ -135,9 +139,24 @@
    </term>
    <listitem>
     <simpara>
+     Disallows writing network files.
     </simpara>
    </listitem>
   </varlistentry>
+  <varlistentry xml:id="constant.xsl-secpref-default">
+   <term>
+    <constant>XSL_SECPREF_DEFAULT</constant>
+    (<type>integer</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Disallows all write access, i.e. a bitmask of
+     <constant>XSL_SECPREF_WRITE_NETWORK</constant> |
+     <constant>XSL_SECPREF_CREATE_DIRECTORY</constant> |
+     <constant>XSL_SECPREF_WRITE_FILE</constant>.
+    </simpara>
+   </listitem>
+  </varlistentry>
  </variablelist>
 </appendix>


Added: phpdoc/en/trunk/reference/xsl/ini.xml
===================================================================
--- phpdoc/en/trunk/reference/xsl/ini.xml	                        (rev 0)
+++ phpdoc/en/trunk/reference/xsl/ini.xml	2015-06-15 13:26:16 UTC (rev 336970)
@@ -0,0 +1,76 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<section xml:id="xsl.configuration" xmlns="http://docbook.org/ns/docbook">
+ &reftitle.runtime;
+ &extension.runtime;
+ <para>
+  <table>
+   <title>XSL Configuration Options</title>
+   <tgroup cols="4">
+    <thead>
+     <row>
+      <entry>&Name;</entry>
+      <entry>&Default;</entry>
+      <entry>&Changeable;</entry>
+      <entry>&Changelog;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry><link linkend="ini.xsl.security-prefs">xsl.security_prefs</link></entry>
+      <entry>"44"</entry>
+      <entry>PHP_INI_ALL</entry>
+      <entry>
+       Available as of PHP 5.3.9. Deprecated as of PHP 5.4.0. Removed as of PHP
+       7.0.0.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </table>
+  &ini.php.constants;
+ </para>
+
+ &ini.descriptions.title;
+
+ <para>
+  <variablelist>
+   <varlistentry xml:id="ini.xsl.security-prefs">
+    <term>
+     <parameter>xsl.security_prefs</parameter>
+     <type>int</type>
+    </term>
+    <listitem>
+     <para>
+      The libxslt security properties. The default
+      (<constant>XSL_SECPREF_DEFAULT</constant>) is not to enable write
+      operations. As of PHP 5.4.0
+      <function>XsltProcessor::setSecurityPrefs</function> should be used
+      instead of this &php.ini; setting.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </para>
+</section>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->


Property changes on: phpdoc/en/trunk/reference/xsl/ini.xml
___________________________________________________________________
Added: svn:keywords
   + Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
Added: svn:eol-style
   + native

Modified: phpdoc/en/trunk/reference/xsl/xsltprocessor/getsecurityprefs.xml
===================================================================
--- phpdoc/en/trunk/reference/xsl/xsltprocessor/getsecurityprefs.xml	2015-06-15 11:57:15 UTC (rev 336969)
+++ phpdoc/en/trunk/reference/xsl/xsltprocessor/getsecurityprefs.xml	2015-06-15 13:26:16 UTC (rev 336970)
@@ -14,11 +14,8 @@
    <void/>
   </methodsynopsis>
   <para>
-
+   Gets the security preferences.
   </para>
-
-  &warn.undocumented.func;
-
  </refsect1>

  <refsect1 role="parameters">
@@ -29,11 +26,13 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
+   A bitmask consisting of <constant>XSL_SECPREF_READ_FILE</constant>,
+   <constant>XSL_SECPREF_WRITE_FILE</constant>,
+   <constant>XSL_SECPREF_CREATE_DIRECTORY</constant>,
+   <constant>XSL_SECPREF_READ_NETWORK</constant>,
+   <constant>XSL_SECPREF_WRITE_NETWORK</constant>.
   </para>
  </refsect1>
-
-
 </refentry>

 <!-- Keep this comment at the end of the file

Modified: phpdoc/en/trunk/reference/xsl/xsltprocessor/setsecurityprefs.xml
===================================================================
--- phpdoc/en/trunk/reference/xsl/xsltprocessor/setsecurityprefs.xml	2015-06-15 11:57:15 UTC (rev 336969)
+++ phpdoc/en/trunk/reference/xsl/xsltprocessor/setsecurityprefs.xml	2015-06-15 13:26:16 UTC (rev 336970)
@@ -14,26 +14,39 @@
    <methodparam><type>int</type><parameter>securityPrefs</parameter></methodparam>
   </methodsynopsis>
   <para>
-
+   Sets the security preferences.
   </para>
-
-  &warn.undocumented.func;
-
  </refsect1>

  <refsect1 role="parameters">
   &reftitle.parameters;
-  &no.function.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>securityPrefs</parameter></term>
+     <listitem>
+      <para>
+       The new security preferences. The following constants can be ORed:
+       <constant>XSL_SECPREF_READ_FILE</constant>,
+       <constant>XSL_SECPREF_WRITE_FILE</constant>,
+       <constant>XSL_SECPREF_CREATE_DIRECTORY</constant>,
+       <constant>XSL_SECPREF_READ_NETWORK</constant>,
+       <constant>XSL_SECPREF_WRITE_NETWORK</constant>. Alternatively,
+       <constant>XSL_SECPREF_NONE</constant> or
+       <constant>XSL_SECPREF_DEFAULT</constant> can be passed.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+   </para>
  </refsect1>

  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
+   Returns the old security preferences.
   </para>
  </refsect1>
-
-
 </refentry>

 <!-- Keep this comment at the end of the file



-- 
PHP Documentation Commits Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

[prev in list] [next in list] [prev in thread] [next in thread] 

Configure | About | News | Add a list | Sponsored by KoreLogic