Skip to content

[Sync EN] Add PHP 8.4.0 changelog entries for Intl and MBString pages #316

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lacatoire wants to merge 1 commit into
base: master
Choose a base branch
from
+679 −0
Open

[Sync EN] Add PHP 8.4.0 changelog entries for Intl and MBString pages #316

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
201 changes: 201 additions & 0 deletions reference/intl/idn/idn-to-ascii.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,201 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1be57c2d7d7306b6167a4305059fe1abe8911699 Maintainer: lacatoire Status: ready -->
<refentry xml:id="function.idn-to-ascii" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>idn_to_ascii</refname>
<refpurpose>Wandelt einen Domainnamen in die IDNA-ASCII-Form um</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>&style.procedural;</para>
<methodsynopsis>
<type class="union"><type>string</type><type>false</type></type><methodname>idn_to_ascii</methodname>
<methodparam><type>string</type><parameter>domain</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>IDNA_DEFAULT</constant></initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>variant</parameter><initializer><constant>INTL_IDNA_VARIANT_UTS46</constant></initializer></methodparam>
<methodparam choice="opt"><type>array</type><parameter role="reference">idna_info</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Diese Funktion wandelt einen Unicode-Domainnamen in ein
IDNA-ASCII-kompatibles Format in Kleinbuchstaben um.
</para>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>domain</parameter></term>
<listitem>
<para>
Die umzuwandelnde Domain, die UTF-8-kodiert sein muss.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
Umwandlungsoptionen - eine Kombination der IDNA_*-Konstanten
(außer den IDNA_ERROR_*-Konstanten).
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>variant</parameter></term>
<listitem>
<para>
Entweder <constant>INTL_IDNA_VARIANT_2003</constant> (veraltet seit
PHP 7.2.0) für IDNA 2003 oder
<constant>INTL_IDNA_VARIANT_UTS46</constant> (erst ab ICU 4.6
verfügbar) für UTS #46.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>idna_info</parameter></term>
<listitem>
<para>
Dieser Parameter kann nur verwendet werden, wenn
<constant>INTL_IDNA_VARIANT_UTS46</constant> für
<parameter>variant</parameter> verwendet wurde. In diesem Fall wird er
mit einem Array gefüllt, das die Schlüssel <literal>'result'</literal>
(das möglicherweise unzulässige Ergebnis der Umwandlung),
<literal>'isTransitionalDifferent'</literal> (ein boolescher Wert, der
angibt, ob die Verwendung der Übergangsmechanismen von UTS #46 das
Ergebnis verändert hat oder verändert hätte) und
<literal>'errors'</literal> (ein <type>int</type>, der einen Bitsatz
der Fehlerkonstanten IDNA_ERROR_* darstellt) enthält.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Der in ASCII-kompatibler Form kodierte Domainname, &return.falseforfailure;
</para>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Wirft nun einen <exceptionname>ValueError</exceptionname>, wenn der
Parameter <parameter>domain</parameter> leer ist.
</entry>
</row>
<row>
<entry>8.4.0</entry>
<entry>
Wirft nun einen <exceptionname>ValueError</exceptionname>, wenn der
Parameter <parameter>variant</parameter> nicht
<constant>INTL_IDNA_VARIANT_UTS46</constant> ist.
</entry>
</row>
<row>
<entry>7.4.0</entry>
<entry>
Der Standardwert von <parameter>variant</parameter> ist nun
<constant>INTL_IDNA_VARIANT_UTS46</constant> anstelle des veralteten
<constant>INTL_IDNA_VARIANT_2003</constant>.
</entry>
</row>
<row>
<entry>7.2.0</entry>
<entry>
<constant>INTL_IDNA_VARIANT_2003</constant> wurde als veraltet
markiert; <constant>INTL_IDNA_VARIANT_UTS46</constant> sollte
stattdessen verwendet werden.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>idn_to_ascii</function>-Beispiel</title>
<programlisting role="php">
<![CDATA[
<?php

echo idn_to_ascii('täst.de');

?>
]]>
</programlisting>
</example>
&example.outputs;
<screen>
<![CDATA[
xn--tst-qla.de
]]>
</screen>
<example>
<title>Reine ASCII-Domainnamen werden nur in Kleinbuchstaben umgewandelt</title>
<programlisting role="php">
<![CDATA[
<?php

var_dump(idn_to_ascii('Example.com'));

?>
]]>
</programlisting>
</example>
&example.outputs;
<screen>
<![CDATA[
string(11) "example.com"
]]>
</screen>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>idn_to_utf8</function></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
-->
183 changes: 183 additions & 0 deletions reference/intl/idn/idn-to-utf8.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,183 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1be57c2d7d7306b6167a4305059fe1abe8911699 Maintainer: lacatoire Status: ready -->
<refentry xml:id="function.idn-to-utf8" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>idn_to_utf8</refname>
<refpurpose>Wandelt einen Domainnamen von IDNA-ASCII nach Unicode um</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>&style.procedural;</para>
<methodsynopsis>
<type class="union"><type>string</type><type>false</type></type><methodname>idn_to_utf8</methodname>
<methodparam><type>string</type><parameter>domain</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>IDNA_DEFAULT</constant></initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>variant</parameter><initializer><constant>INTL_IDNA_VARIANT_UTS46</constant></initializer></methodparam>
<methodparam choice="opt"><type>array</type><parameter role="reference">idna_info</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Diese Funktion wandelt einen Unicode-Domainnamen aus einem
IDNA-ASCII-kompatiblen Format in reines Unicode um, kodiert in UTF-8.
</para>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>domain</parameter></term>
<listitem>
<para>
Die umzuwandelnde Domain in einem IDNA-ASCII-kompatiblen Format.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
Umwandlungsoptionen - eine Kombination der IDNA_*-Konstanten
(außer den IDNA_ERROR_*-Konstanten).
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>variant</parameter></term>
<listitem>
<para>
Entweder <constant>INTL_IDNA_VARIANT_2003</constant> (veraltet seit
PHP 7.2.0) für IDNA 2003 oder
<constant>INTL_IDNA_VARIANT_UTS46</constant> (erst ab ICU 4.6
verfügbar) für UTS #46.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>idna_info</parameter></term>
<listitem>
<para>
Dieser Parameter kann nur verwendet werden, wenn
<constant>INTL_IDNA_VARIANT_UTS46</constant> für
<parameter>variant</parameter> verwendet wurde. In diesem Fall wird er
mit einem Array gefüllt, das die Schlüssel <literal>'result'</literal>
(das möglicherweise unzulässige Ergebnis der Umwandlung),
<literal>'isTransitionalDifferent'</literal> (ein boolescher Wert, der
angibt, ob die Verwendung der Übergangsmechanismen von UTS #46 das
Ergebnis verändert hat oder verändert hätte) und
<literal>'errors'</literal> (ein <type>int</type>, der einen Bitsatz
der Fehlerkonstanten IDNA_ERROR_* darstellt) enthält.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Der Domainname in Unicode, kodiert in UTF-8, &return.falseforfailure;
</para>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Wirft nun einen <exceptionname>ValueError</exceptionname>, wenn der
Parameter <parameter>domain</parameter> leer ist.
</entry>
</row>
<row>
<entry>8.4.0</entry>
<entry>
Wirft nun einen <exceptionname>ValueError</exceptionname>, wenn der
Parameter <parameter>variant</parameter> nicht
<constant>INTL_IDNA_VARIANT_UTS46</constant> ist.
</entry>
</row>
<row>
<entry>7.4.0</entry>
<entry>
Der Standardwert von <parameter>variant</parameter> ist nun
<constant>INTL_IDNA_VARIANT_UTS46</constant> anstelle des veralteten
<constant>INTL_IDNA_VARIANT_2003</constant>.
</entry>
</row>
<row>
<entry>7.2.0</entry>
<entry>
<constant>INTL_IDNA_VARIANT_2003</constant> wurde als veraltet
markiert; <constant>INTL_IDNA_VARIANT_UTS46</constant> sollte
stattdessen verwendet werden.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>idn_to_utf8</function>-Beispiel</title>
<programlisting role="php">
<![CDATA[
<?php

echo idn_to_utf8('xn--tst-qla.de');

?>
]]>
</programlisting>
</example>
&example.outputs;
<screen>
<![CDATA[
täst.de
]]>
</screen>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>idn_to_ascii</function></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