Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
684 changes: 684 additions & 0 deletions reference/com/constants.xml

Large diffs are not rendered by default.

207 changes: 207 additions & 0 deletions reference/com/ini.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,207 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 525aa5f198d482c0d03be54ddee5af13b376ab99 Maintainer: lacatoire Status: ready -->
<!-- Reviewed: no -->
<section xml:id="com.configuration" xmlns="http://docbook.org/ns/docbook">
&reftitle.runtime;
&extension.runtime;
<para>
<table>
<title>Com-Konfigurationsoptionen</title>
<tgroup cols="4">
<thead>
<row>
<entry>&Name;</entry>
<entry>&Default;</entry>
<entry>&Changeable;</entry>
<entry>&Changelog;</entry>
</row>
</thead>
<tbody xml:id="com.configuration.list">
<row>
<entry><link linkend="ini.com.allow-dcom">com.allow_dcom</link></entry>
<entry>"0"</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.com.autoregister-typelib">com.autoregister_typelib</link></entry>
<entry>"0"</entry>
<entry><constant>INI_ALL</constant></entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.com.autoregister-verbose">com.autoregister_verbose</link></entry>
<entry>"0"</entry>
<entry><constant>INI_ALL</constant></entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.com.autoregister-casesensitive">com.autoregister_casesensitive</link></entry>
<entry>"1"</entry>
<entry><constant>INI_ALL</constant></entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.com.code-page">com.code_page</link></entry>
<entry>""</entry>
<entry><constant>INI_ALL</constant></entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.com.dotnet-version">com.dotnet_version</link></entry>
<entry>""</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Ab PHP 8.0.0</entry>
</row>
<row>
<entry><link linkend="ini.com.typelib-file">com.typelib_file</link></entry>
<entry>""</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>
&ini.php.constants;
</para>

&ini.descriptions.title;

<para>
<variablelist>
<varlistentry xml:id="ini.com.allow-dcom">
<term>
<parameter>com.allow_dcom</parameter>
</term>
<listitem>
<para>
Ist dies eingeschaltet, darf PHP als D-COM-Client (Distributed COM)
arbeiten und das PHP-Skript darf
COM-Objekte auf einem entfernten Server instanziieren.
</para>
</listitem>
</varlistentry>

<varlistentry xml:id="ini.com.autoregister-typelib">
<term>
<parameter>com.autoregister_typelib</parameter>
</term>
<listitem>
<para>
Ist dies eingeschaltet, versucht PHP, Konstanten aus
der Typbibliothek der instanziierten <classname>COM</classname>-Objekte zu registrieren, sofern diese Objekte
die zum Abrufen dieser Information erforderlichen Schnittstellen implementieren.
Die Beachtung der Groß-/Kleinschreibung der registrierten Konstanten wird durch die
&php.ini;-Direktive <link
linkend="ini.com.autoregister-casesensitive">com.autoregister_casesensitive</link> gesteuert.
</para>
</listitem>
</varlistentry>

<varlistentry xml:id="ini.com.autoregister-verbose">
<term>
<parameter>com.autoregister_verbose</parameter>
</term>
<listitem>
<para>
Ist dies eingeschaltet, werden alle Probleme beim Laden einer Typbibliothek während
der Objektinstanziierung über den PHP-Fehlermechanismus gemeldet.
Die Vorgabe ist „aus“, wodurch kein Hinweis ausgegeben wird, falls beim
Finden oder Laden der Typbibliothek ein Fehler aufgetreten ist.
</para>
</listitem>
</varlistentry>

<varlistentry xml:id="ini.com.autoregister-casesensitive">
<term>
<parameter>com.autoregister_casesensitive</parameter>
</term>
<listitem>
<simpara>
Ist dies eingeschaltet (die Vorgabe), werden Konstanten, die beim Instanziieren von
<classname>COM</classname>-Objekten in automatisch geladenen Typbibliotheken gefunden werden, unter Beachtung der Groß-/Kleinschreibung registriert. Siehe
<function>com_load_typelib</function> für weitere Einzelheiten.
</simpara>
</listitem>
</varlistentry>

<varlistentry xml:id="ini.com.code-page">
<term>
<parameter>com.code_page</parameter>
</term>
<listitem>
<para>
Steuert die Standard-Codepage des Zeichensatzes, die beim Übergeben
von Zeichenketten an und von COM-Objekten verwendet wird. Wird sie auf eine leere Zeichenkette gesetzt, nimmt PHP
an, dass <constant>CP_ACP</constant> gewünscht ist, also die standardmäßige
ANSI-Codepage des Systems.
</para>
<para>
Ist der Text in den Skripten standardmäßig mit einer anderen
Kodierung/einem anderen Zeichensatz kodiert, erspart das Setzen dieser Direktive,
die Codepage als Parameter an den Konstruktor der Klasse <xref
linkend="class.com"/> übergeben zu müssen. Zu beachten ist, dass das
Skript durch die Verwendung dieser Direktive (wie bei jeder PHP-Konfigurationsdirektive) weniger portabel
wird; nach Möglichkeit sollte der Parameter des COM-Konstruktors
verwendet werden.
</para>
</listitem>
</varlistentry>

<varlistentry xml:id="ini.com.dotnet-version">
<term>
<parameter>com.dotnet_version</parameter>
</term>
<listitem>
<para>
Die Version des .NET-Frameworks, die für <classname>dotnet</classname>-Objekte verwendet wird.
Der Wert der Einstellung sind die ersten drei Teile der Versionsnummer des Frameworks,
getrennt durch Punkte und mit <literal>v</literal> als Präfix, z. B. <literal>v4.0.30319</literal>.
</para>
</listitem>
</varlistentry>

<varlistentry xml:id="ini.com.typelib-file">
<term>
<parameter>com.typelib_file</parameter>
</term>
<listitem>
<para>
Ist dies gesetzt, sollte es den Pfad zu einer Datei enthalten, die eine Liste
der Typbibliotheken enthält, die beim Start geladen werden sollen. Jede Zeile
der Datei wird als Name der Typbibliothek behandelt und so geladen,
als ob <function>com_load_typelib</function> aufgerufen worden wäre.
Die Konstanten werden dauerhaft registriert, sodass die Bibliothek
nur einmal geladen werden muss. Endet ein Name einer Typbibliothek mit der
Zeichenkette <literal>#cis</literal> oder <literal>#case_insensitive</literal>,
werden die Konstanten dieser Bibliothek ohne Beachtung der
Groß-/Kleinschreibung registriert.
</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
-->
107 changes: 107 additions & 0 deletions reference/dom/domdocument/getelementbyid.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,107 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 7cecc752c7a19aa6ea422ac7ae82952a21bedd67 Maintainer: lacatoire Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="domdocument.getelementbyid" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMDocument::getElementById</refname>
<refpurpose>Sucht nach einem Element mit einer bestimmten ID</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="DOMDocument">
<modifier>public</modifier> <type class="union"><type>DOMElement</type><type>null</type></type><methodname>DOMDocument::getElementById</methodname>
<methodparam><type>string</type><parameter>elementId</parameter></methodparam>
</methodsynopsis>
<para>
Diese Funktion ähnelt
<xref linkend="domdocument.getelementsbytagname"/>, sucht aber
nach einem Element mit einer bestimmten ID.
</para>
<simpara>
Damit diese Funktion arbeitet, müssen entweder einige ID-Attribute
mit <xref linkend="domelement.setidattribute"/> gesetzt werden
oder es muss eine DTD vorliegen, die ein Attribut als vom Typ ID definiert.
Im letzteren Fall muss das Dokument vor der Verwendung dieser Funktion mit
<xref linkend="domdocument.validate"/>
oder <link linkend="domdocument.props.validateonparse">DOMDocument::$validateOnParse</link> validiert werden.
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>elementId</parameter></term>
<listitem>
<para>
Der eindeutige ID-Wert eines Elements.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Gibt das <classname>DOMElement</classname> oder &null; zurück, wenn das Element
nicht gefunden wird.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Beispiel für DOMDocument::getElementById()</title>
&dom.book.example;
<programlisting role="php">
<![CDATA[
<?php

$doc = new DomDocument;

// Wir müssen unser Dokument validieren, bevor wir auf die ID verweisen
$doc->validateOnParse = true;
$doc->load('examples/book.xml');

echo "The element whose id is 'php-basics' is: " . $doc->getElementById('php-basics')->tagName . "\n";

?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
The element whose id is 'php-basics' is: book
]]>
</screen>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>DOMDocument::getElementsByTagName</methodname></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- 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
-->
Loading
Loading