From 0752ffee044bc6a8ef0cb5f9d716273e7ec0741b Mon Sep 17 00:00:00 2001 From: Philippe Delente Date: Fri, 9 May 2025 16:11:14 +0200 Subject: [PATCH] feat add translate page dom + rmpinfo + misc --- reference/dom/domcharacterdata/after.xml | 84 + reference/dom/domdocumentfragment/append.xml | 83 + .../dom/domdocumentfragment/construct.xml | 42 + reference/dom/domdocumentfragment/prepend.xml | 83 + .../domdocumentfragment/replacechildren.xml | 86 + reference/dom/domelement/after.xml | 86 + reference/dom/domelement/append.xml | 84 + reference/dom/domelement/before.xml | 85 + .../dom/domelement/getattributenames.xml | 82 + .../dom/domelement/insertadjacenttext.xml | 117 + reference/dom/domelement/prepend.xml | 84 + reference/dom/domelement/remove.xml | 84 + reference/dom/domelement/replacechildren.xml | 88 + reference/dom/domelement/replacewith.xml | 87 + reference/dom/domelement/toggleattribute.xml | 110 + reference/dom/domnamednodemap/count.xml | 54 + reference/dom/domnamednodemap/getiterator.xml | 52 + reference/dom/domnodelist/getiterator.xml | 52 + .../dom/functions/dom-ns-import-simplexml.xml | 94 + .../errorfunc/functions/get-error-handler.xml | 123 + .../functions/get-exception-handler.xml | 123 + reference/ftp/ftp.connection.xml | 56 + reference/ftp/functions/ftp-append.xml | 107 + reference/ftp/functions/ftp-mlsd.xml | 221 ++ reference/gearman/gearmanclient/wait.xml | 62 + reference/gettext/functions/-.xml | 38 + reference/gmp/functions/gmp-binomial.xml | 102 + reference/gmp/functions/gmp-kronecker.xml | 78 + reference/gmp/functions/gmp-lcm.xml | 76 + reference/gmp/functions/gmp-perfect-power.xml | 68 + reference/gmp/functions/gmp-random-bits.xml | 106 + reference/gmp/functions/gmp-random-range.xml | 119 + reference/gmp/gmp/construct.xml | 55 + reference/gmp/gmp/serialize.xml | 56 + reference/gmp/gmp/unserialize.xml | 65 + reference/gnupg/functions/gnupg-deletekey.xml | 105 + .../gnupg/functions/gnupg-getengineinfo.xml | 114 + .../gnupg/functions/gnupg-geterrorinfo.xml | 121 + .../gnupg/functions/gnupg-gettrustlist.xml | 99 + .../gnupg/functions/gnupg-listsignatures.xml | 99 + reference/hash/functions/hash-hkdf.xml | 189 ++ reference/hash/functions/hash-hmac-algos.xml | 138 + reference/hash/hashcontext.xml | 67 + reference/hash/hashcontext/construct.xml | 43 + reference/hash/hashcontext/serialize.xml | 56 + reference/hash/hashcontext/unserialize.xml | 65 + reference/rpminfo/book.xml | 46 + reference/rpminfo/constants.xml | 2936 +++++++++++++++++ reference/rpminfo/functions/rpmaddtag.xml | 71 + reference/rpminfo/functions/rpmdbinfo.xml | 111 + reference/rpminfo/functions/rpmdbsearch.xml | 131 + reference/rpminfo/functions/rpmdefine.xml | 105 + reference/rpminfo/functions/rpmexpand.xml | 90 + .../rpminfo/functions/rpmexpandnumeric.xml | 94 + reference/rpminfo/functions/rpmgetsymlink.xml | 73 + reference/rpminfo/functions/rpminfo.xml | 120 + reference/rpminfo/functions/rpmvercmp.xml | 129 + reference/rpminfo/reference.xml | 29 + reference/rpminfo/setup.xml | 42 + 59 files changed, 8065 insertions(+) create mode 100644 reference/dom/domcharacterdata/after.xml create mode 100644 reference/dom/domdocumentfragment/append.xml create mode 100644 reference/dom/domdocumentfragment/construct.xml create mode 100644 reference/dom/domdocumentfragment/prepend.xml create mode 100644 reference/dom/domdocumentfragment/replacechildren.xml create mode 100644 reference/dom/domelement/after.xml create mode 100644 reference/dom/domelement/append.xml create mode 100644 reference/dom/domelement/before.xml create mode 100644 reference/dom/domelement/getattributenames.xml create mode 100644 reference/dom/domelement/insertadjacenttext.xml create mode 100644 reference/dom/domelement/prepend.xml create mode 100644 reference/dom/domelement/remove.xml create mode 100644 reference/dom/domelement/replacechildren.xml create mode 100644 reference/dom/domelement/replacewith.xml create mode 100644 reference/dom/domelement/toggleattribute.xml create mode 100644 reference/dom/domnamednodemap/count.xml create mode 100644 reference/dom/domnamednodemap/getiterator.xml create mode 100644 reference/dom/domnodelist/getiterator.xml create mode 100644 reference/dom/functions/dom-ns-import-simplexml.xml create mode 100644 reference/errorfunc/functions/get-error-handler.xml create mode 100644 reference/errorfunc/functions/get-exception-handler.xml create mode 100644 reference/ftp/ftp.connection.xml create mode 100644 reference/ftp/functions/ftp-append.xml create mode 100644 reference/ftp/functions/ftp-mlsd.xml create mode 100644 reference/gearman/gearmanclient/wait.xml create mode 100644 reference/gettext/functions/-.xml create mode 100644 reference/gmp/functions/gmp-binomial.xml create mode 100644 reference/gmp/functions/gmp-kronecker.xml create mode 100644 reference/gmp/functions/gmp-lcm.xml create mode 100644 reference/gmp/functions/gmp-perfect-power.xml create mode 100644 reference/gmp/functions/gmp-random-bits.xml create mode 100644 reference/gmp/functions/gmp-random-range.xml create mode 100644 reference/gmp/gmp/construct.xml create mode 100644 reference/gmp/gmp/serialize.xml create mode 100644 reference/gmp/gmp/unserialize.xml create mode 100644 reference/gnupg/functions/gnupg-deletekey.xml create mode 100644 reference/gnupg/functions/gnupg-getengineinfo.xml create mode 100644 reference/gnupg/functions/gnupg-geterrorinfo.xml create mode 100644 reference/gnupg/functions/gnupg-gettrustlist.xml create mode 100644 reference/gnupg/functions/gnupg-listsignatures.xml create mode 100644 reference/hash/functions/hash-hkdf.xml create mode 100644 reference/hash/functions/hash-hmac-algos.xml create mode 100644 reference/hash/hashcontext.xml create mode 100644 reference/hash/hashcontext/construct.xml create mode 100644 reference/hash/hashcontext/serialize.xml create mode 100644 reference/hash/hashcontext/unserialize.xml create mode 100644 reference/rpminfo/book.xml create mode 100644 reference/rpminfo/constants.xml create mode 100644 reference/rpminfo/functions/rpmaddtag.xml create mode 100644 reference/rpminfo/functions/rpmdbinfo.xml create mode 100644 reference/rpminfo/functions/rpmdbsearch.xml create mode 100644 reference/rpminfo/functions/rpmdefine.xml create mode 100644 reference/rpminfo/functions/rpmexpand.xml create mode 100644 reference/rpminfo/functions/rpmexpandnumeric.xml create mode 100644 reference/rpminfo/functions/rpmgetsymlink.xml create mode 100644 reference/rpminfo/functions/rpminfo.xml create mode 100644 reference/rpminfo/functions/rpmvercmp.xml create mode 100644 reference/rpminfo/reference.xml create mode 100644 reference/rpminfo/setup.xml diff --git a/reference/dom/domcharacterdata/after.xml b/reference/dom/domcharacterdata/after.xml new file mode 100644 index 000000000..6e1be966f --- /dev/null +++ b/reference/dom/domcharacterdata/after.xml @@ -0,0 +1,84 @@ + + + + + + DOMCharacterData::after + Añade nodos después de los datos + + + + &reftitle.description; + + public voidDOMCharacterData::after + DOMNodestringnodes + + + Añade los nodes pasados después de los datos de carácter. + + + + + + + + + + &reftitle.examples; + + Ejemplo de <methodname>DOMCharacterData::after</methodname> + + Añade nodos después de los datos. + + +loadXML(""); +$cdata = $doc->documentElement->firstChild; + +$cdata->after("beautiful", $doc->createElement("world")); + +echo $doc->saveXML(); +?> +]]> + + &example.outputs; + + +beautiful +]]> + + + + + + &reftitle.seealso; + + DOMChildNode::after + DOMCharacterData::before + + + + + diff --git a/reference/dom/domdocumentfragment/append.xml b/reference/dom/domdocumentfragment/append.xml new file mode 100644 index 000000000..00b3b45e9 --- /dev/null +++ b/reference/dom/domdocumentfragment/append.xml @@ -0,0 +1,83 @@ + + + + + + DOMDocumentFragment::append + Añade nodos después del último nodo hijo + + + + &reftitle.description; + + public voidDOMDocumentFragment::append + DOMNodestringnodes + + + Añade uno o varios nodes a la lista de hijos después del último nodo hijo. + + + + + + + + + + &reftitle.examples; + + Ejemplo de <methodname>DOMDocumentFragment::append</methodname> + + Añade nodos en el fragmento. + + +createDocumentFragment(); +$fragment->appendChild($doc->createElement("hello")); + +$fragment->append("beautiful", $doc->createElement("world")); + +echo $doc->saveXML($fragment); +?> +]]> + + &example.outputs; + +beautiful +]]> + + + + + + &reftitle.seealso; + + DOMParentNode::append + DOMDocumentFragment::prepend + + + + + diff --git a/reference/dom/domdocumentfragment/construct.xml b/reference/dom/domdocumentfragment/construct.xml new file mode 100644 index 000000000..34f0784da --- /dev/null +++ b/reference/dom/domdocumentfragment/construct.xml @@ -0,0 +1,42 @@ + + + + + + DOMDocumentFragment::__construct + Construye un objeto DOMDocumentFragment + + + + &reftitle.description; + + public DOMDocumentFragment::__construct + + + + + + &reftitle.parameters; + &no.function.parameters; + + + diff --git a/reference/dom/domdocumentfragment/prepend.xml b/reference/dom/domdocumentfragment/prepend.xml new file mode 100644 index 000000000..4637e258a --- /dev/null +++ b/reference/dom/domdocumentfragment/prepend.xml @@ -0,0 +1,83 @@ + + + + + + DOMDocumentFragment::prepend + Añade nodos antes del primer nodo hijo + + + + &reftitle.description; + + public voidDOMDocumentFragment::prepend + DOMNodestringnodes + + + Añade uno o varios nodes a la lista de hijos antes del primer nodo hijo. + + + + + + + + + + &reftitle.examples; + + Ejemplo de <methodname>DOMDocumentFragment::prepend</methodname> + + Añade nodos antes del fragmento raíz. + + +createDocumentFragment(); +$fragment->appendChild($doc->createElement("world")); + +$fragment->prepend($doc->createElement("hello"), "beautiful"); + +echo $doc->saveXML($fragment); +?> +]]> + + &example.outputs; + +beautiful +]]> + + + + + + &reftitle.seealso; + + DOMParentNode::prepend + DOMDocumentFragment::append + + + + + diff --git a/reference/dom/domdocumentfragment/replacechildren.xml b/reference/dom/domdocumentfragment/replacechildren.xml new file mode 100644 index 000000000..e0c95163a --- /dev/null +++ b/reference/dom/domdocumentfragment/replacechildren.xml @@ -0,0 +1,86 @@ + + + + + + DOMDocumentFragment::replaceChildren + Reemplaza los hijos en el fragmento + + + + &reftitle.description; + + public voidDOMDocumentFragment::replaceChildren + DOMNodestringnodes + + + Reemplaza los hijos en el fragmento por nuevos nodes. + + + + + + + + + + &reftitle.examples; + + Ejemplo de <methodname>DOMDocumentFragment::replaceChildren</methodname> + + Reemplaza los hijos por nuevos nodos. + + +loadXML(""); +$fragment = $doc->createDocumentFragment(); +$fragment->append("hello"); + +$fragment->replaceChildren("beautiful", $doc->createElement("world")); + +echo $doc->saveXML($fragment); +?> +]]> + + &example.outputs; + + +]]> + + + + + + &reftitle.seealso; + + DOMParentNode::replaceChildren + DOMDocumentFragment::append + DOMDocumentFragment::prepend + + + + + diff --git a/reference/dom/domelement/after.xml b/reference/dom/domelement/after.xml new file mode 100644 index 000000000..4258fdd59 --- /dev/null +++ b/reference/dom/domelement/after.xml @@ -0,0 +1,86 @@ + + + + + + DOMElement::after + Añade nodos después del elemento + + + + &reftitle.description; + + public voidDOMElement::after + DOMNodestringnodes + + + Añade los nodes pasados después del elemento. + + + + + + + + + + &reftitle.examples; + + Ejemplo de <methodname>DOMElement::after</methodname> + + Añade los nodos después del elemento hello. + + +loadXML(""); +$container = $doc->documentElement; + +$container->after("beautiful", $doc->createElement("world")); + +echo $doc->saveXML(); +?> +]]> + + &example.outputs; + + + +beautiful + +]]> + + + + + + &reftitle.seealso; + + DOMChildNode::after + DOMElement::before + + + + + diff --git a/reference/dom/domelement/append.xml b/reference/dom/domelement/append.xml new file mode 100644 index 000000000..9ac9f6fa0 --- /dev/null +++ b/reference/dom/domelement/append.xml @@ -0,0 +1,84 @@ + + + + + + DOMElement::append + Añade nodos después del último hijo + + + + &reftitle.description; + + public voidDOMElement::append + DOMNodestringnodes + + + Añade uno o varios nodes a la lista de hijos después del último nodo hijo. + + + + + + + + + + &reftitle.examples; + + Ejemplo de <methodname>DOMElement::append</methodname> + + Añade nodos en el elemento contenedor. + + +loadXML("hello "); +$world = $doc->documentElement; + +$world->append("beautiful", $doc->createElement("world")); + +echo $doc->saveXML(); +?> +]]> + + &example.outputs; + + +hello beautiful +]]> + + + + + + &reftitle.seealso; + + DOMParentNode::append + DOMElement::prepend + + + + + diff --git a/reference/dom/domelement/before.xml b/reference/dom/domelement/before.xml new file mode 100644 index 000000000..3fac60e62 --- /dev/null +++ b/reference/dom/domelement/before.xml @@ -0,0 +1,85 @@ + + + + + + DOMElement::before + Añade nodos antes del elemento + + + + &reftitle.description; + + public voidDOMElement::before + DOMNodestringnodes + + + Añade los nodes pasados antes del elemento. + + + + + + + + + + &reftitle.examples; + + Ejemplo de <methodname>DOMElement::before</methodname> + + Añade los nodos antes del elemento hello. + + +loadXML(""); +$world = $doc->documentElement; + +$world->before("hello", $doc->createElement("beautiful")); + +echo $doc->saveXML(); +?> +]]> + + &example.outputs; + + + +]]> + + + + + + &reftitle.seealso; + + DOMChildNode::before + DOMElement::after + + + + + diff --git a/reference/dom/domelement/getattributenames.xml b/reference/dom/domelement/getattributenames.xml new file mode 100644 index 000000000..f408d395f --- /dev/null +++ b/reference/dom/domelement/getattributenames.xml @@ -0,0 +1,82 @@ + + + + + + DOMElement::getAttributeNames + Devuelve los nombres de los atributos + + + + &reftitle.description; + + public arrayDOMElement::getAttributeNames + + + + Obtener los nombres de los atributos. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Devuelve los nombres de los atributos. + + + + + &reftitle.examples; + + Ejemplo de <methodname>DOMElement::getAttributeNames</methodname> + +loadXML(''); +var_dump($dom->documentElement->getAttributeNames()); +?> +]]> + + &example.outputs; + + + string(10) "xmlns:some" + [1]=> + string(9) "some:test" + [2]=> + string(5) "test2" +} +]]> + + + + + diff --git a/reference/dom/domelement/insertadjacenttext.xml b/reference/dom/domelement/insertadjacenttext.xml new file mode 100644 index 000000000..c91aab4d6 --- /dev/null +++ b/reference/dom/domelement/insertadjacenttext.xml @@ -0,0 +1,117 @@ + + + + + + DOMElement::insertAdjacentText + Inserta un texto adyacente + + + + &reftitle.description; + + public voidDOMElement::insertAdjacentText + stringwhere + stringdata + + + Inserta un texto en una posición relativa dada por where. + + + + + &reftitle.parameters; + + + + where + + + + beforebegin - Inserta antes del elemento objetivo. + afterbegin - Inserta como primer hijo del elemento objetivo. + beforeend - Inserta como último hijo del elemento objetivo. + afterend - Inserta después del elemento objetivo. + + + + + + data + + + El string a insertar. + + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.examples; + + Ejemplo de <methodname>DOMElement::insertAdjacentText</methodname> + +loadXML('

H

'); + +$container = $dom->documentElement; +$p = $container->firstElementChild; + +$p->insertAdjacentText("afterbegin", "P"); +$p->insertAdjacentText("beforeend", "P"); + +echo $dom->saveXML(); +?> +]]> + + &example.outputs; + + +

PHP

 +]]> + + + + + + &reftitle.seealso; + + + DOMElement::insertAdjacentElement + + + + + diff --git a/reference/dom/domelement/prepend.xml b/reference/dom/domelement/prepend.xml new file mode 100644 index 000000000..922024a89 --- /dev/null +++ b/reference/dom/domelement/prepend.xml @@ -0,0 +1,84 @@ + + + + + + DOMElement::prepend + Añade nodos antes del primer hijo + + + + &reftitle.description; + + public voidDOMElement::prepend + DOMNodestringnodes + + + Añade uno o varios nodes a la lista de hijos antes del primer nodo hijo. + + + + + + + + + + &reftitle.examples; + + Ejemplo de <methodname>DOMElement::prepend</methodname> + + Añade los nodos antes del elemento contenedor. + + +loadXML(" world"); +$world = $doc->documentElement; + +$world->prepend($doc->createElement("hello"), "beautiful"); + +echo $doc->saveXML(); +?> +]]> + + &example.outputs; + + +beautiful world +]]> + + + + + + &reftitle.seealso; + + DOMParentNode::prepend + DOMElement::append + + + + + diff --git a/reference/dom/domelement/remove.xml b/reference/dom/domelement/remove.xml new file mode 100644 index 000000000..03c63a093 --- /dev/null +++ b/reference/dom/domelement/remove.xml @@ -0,0 +1,84 @@ + + + + + + DOMElement::remove + Elimina el elemento + + + + &reftitle.description; + + public voidDOMElement::remove + + + + Elimina el elemento. + + + + + + + + &reftitle.examples; + + Ejemplo de <methodname>DOMElement::remove</methodname> + + Elimina el elemento. + + +loadXML(""); +$hello = $doc->documentElement->firstChild; + +$hello->remove(); + +echo $doc->saveXML(); +?> +]]> + + &example.outputs; + + + +]]> + + + + + + &reftitle.seealso; + + DOMElement::after + DOMElement::before + DOMElement::replaceWith + DOMNode::removeChild + + + + + diff --git a/reference/dom/domelement/replacechildren.xml b/reference/dom/domelement/replacechildren.xml new file mode 100644 index 000000000..14bd87139 --- /dev/null +++ b/reference/dom/domelement/replacechildren.xml @@ -0,0 +1,88 @@ + + + + + + DOMElement::replaceChildren + Reemplaza los hijos en el elemento + + + + &reftitle.description; + + public voidDOMElement::replaceChildren + DOMNodestringnodes + + + Reemplaza los hijos en el elemento por nuevos nodes. + + + + + + + + + + &reftitle.examples; + + Ejemplo de <methodname>DOMElement::replaceChildren</methodname> + + Reemplaza los hijos por nuevos nodos. + + +loadXML(""); +$container = $doc->documentElement; + +$container->replaceWith("beautiful", $doc->createElement("world")); + +echo $doc->saveXML(); +?> +]]> + + &example.outputs; + + +beautiful + +]]> + + + + + + &reftitle.seealso; + + DOMParentNode::replaceChildren + DOMElement::replaceWith + DOMElement::after + DOMElement::before + DOMElement::remove + + + + + diff --git a/reference/dom/domelement/replacewith.xml b/reference/dom/domelement/replacewith.xml new file mode 100644 index 000000000..945371f82 --- /dev/null +++ b/reference/dom/domelement/replacewith.xml @@ -0,0 +1,87 @@ + + + + + + DOMElement::replaceWith + Reemplaza el elemento por nuevos nodos + + + + &reftitle.description; + + public voidDOMElement::replaceWith + DOMNodestringnodes + + + Reemplaza el elemento por nuevos nodes. + + + + + + + + + + &reftitle.examples; + + Ejemplo de <methodname>DOMElement::replaceWith</methodname> + + Reemplaza el elemento por nuevos nodos. + + +loadXML(""); +$cdata = $doc->documentElement->firstChild; + +$cdata->replaceWith("beautiful", $doc->createElement("world")); + +echo $doc->saveXML(); +?> +]]> + + &example.outputs; + + +beautiful +]]> + + + + + + &reftitle.seealso; + + DOMChildNode::replaceWith + DOMElement::replaceChildren + DOMElement::after + DOMElement::before + DOMElement::remove + + + + + diff --git a/reference/dom/domelement/toggleattribute.xml b/reference/dom/domelement/toggleattribute.xml new file mode 100644 index 000000000..750eccb54 --- /dev/null +++ b/reference/dom/domelement/toggleattribute.xml @@ -0,0 +1,110 @@ + + + + + + DOMElement::toggleAttribute + Conmuta el atributo + + + + &reftitle.description; + + public boolDOMElement::toggleAttribute + stringqualifiedName + boolnullforce&null; + + + Conmuta el atributo. + + + + + &reftitle.parameters; + + + + qualifiedName + + + El nombre cualificado del atributo. + + + + + force + + + + si &null;, la función conmuta el atributo. + si &true;, la función añade el atributo. + si &false;, la función elimina el atributo. + + + + + + + + + + &reftitle.returnvalues; + + Devuelve &true; si el atributo está presente después de la llamada, en caso contrario &false;. + + + + + &reftitle.examples; + + Ejemplo de <methodname>DOMElement::toggleAttribute</methodname> + +loadXML(""); + +var_dump($dom->documentElement->toggleAttribute('selected')); +echo $dom->saveXML() . PHP_EOL; + +var_dump($dom->documentElement->toggleAttribute('selected')); +echo $dom->saveXML(); +?> +]]> + + &example.outputs; + + + + +bool(true) + + +]]> + + + + + diff --git a/reference/dom/domnamednodemap/count.xml b/reference/dom/domnamednodemap/count.xml new file mode 100644 index 000000000..1669e3c98 --- /dev/null +++ b/reference/dom/domnamednodemap/count.xml @@ -0,0 +1,54 @@ + + + + + + DOMNamedNodeMap::count + Obtiene el número de nodos en la colección no ordenada (map) + + + + &reftitle.description; + + public intDOMNamedNodeMap::count + + + + Obtiene el número de nodos en la colección no ordenada (map). + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Devuelve el número de nodos en la colección no ordenada, lo cual es idéntico a + la propiedad length. + + + + + diff --git a/reference/dom/domnamednodemap/getiterator.xml b/reference/dom/domnamednodemap/getiterator.xml new file mode 100644 index 000000000..c7761612e --- /dev/null +++ b/reference/dom/domnamednodemap/getiterator.xml @@ -0,0 +1,52 @@ + + + + + + DOMNamedNodeMap::getIterator + Obtiene un iterador externo + + + + &reftitle.description; + + public IteratorDOMNamedNodeMap::getIterator + + + + Devuelve un iterador externo para la colección de nodos nombrados. + + + + + + + + + &reftitle.seealso; + + IteratorAggregate::getIterator + + + + + diff --git a/reference/dom/domnodelist/getiterator.xml b/reference/dom/domnodelist/getiterator.xml new file mode 100644 index 000000000..947b2ccdb --- /dev/null +++ b/reference/dom/domnodelist/getiterator.xml @@ -0,0 +1,52 @@ + + + + + + DOMNodeList::getIterator + Devuelve un iterador externo + + + + &reftitle.description; + + public IteratorDOMNodeList::getIterator + + + + Devuelve un iterador externo para la lista de nodos. + + + + + + + + + &reftitle.seealso; + + IteratorAggregate::getIterator + + + + + diff --git a/reference/dom/functions/dom-ns-import-simplexml.xml b/reference/dom/functions/dom-ns-import-simplexml.xml new file mode 100644 index 000000000..f252fc3c3 --- /dev/null +++ b/reference/dom/functions/dom-ns-import-simplexml.xml @@ -0,0 +1,94 @@ + + + + + + Dom\import_simplexml + + Devuelve un objeto Dom\Attr o Dom\Element a partir de un + objeto SimpleXMLElement + + + + &reftitle.description; + + Dom\AttrDom\ElementDom\import_simplexml + objectnode + + + Esta función toma el atributo o el elemento node dado (una instancia de + SimpleXMLElement) y crea + un nodo Dom\Attr o Dom\Element, respectivamente. + El nuevo Dom\Node hace referencia al mismo nodo XML subyacente + que el SimpleXMLElement. + + + + + + + + + + + &reftitle.returnvalues; + + El Dom\Attr o Dom\Element. + + + + + &reftitle.examples; + + Importa SimpleXML en DOM y modifica SimpleXML a través de DOM + + La gestión de errores se omite por brevedad. + + +blah'); +$elt = Dom\import_simplexml($sxe); +$elt->setAttribute("foo", "bar"); +echo $sxe->asXML(); + +?> +]]> + + &example.outputs; + + +blah +]]> + + + + + &reftitle.seealso; + + simplexml_import_dom + + + + diff --git a/reference/errorfunc/functions/get-error-handler.xml b/reference/errorfunc/functions/get-error-handler.xml new file mode 100644 index 000000000..ad352502a --- /dev/null +++ b/reference/errorfunc/functions/get-error-handler.xml @@ -0,0 +1,123 @@ + + + + + + get_error_handler + Devuelve la función de gestión de errores definida por el usuario + + + + &reftitle.description; + + callablenullget_error_handler + + + + Devuelve la función de gestión de errores definida por el usuario, si se ha definido alguna. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Devuelve la función de gestión de errores definida. + Si se utiliza el gestor por omisión, se devuelve &null;. + + + El gestor devuelto es la función de retrollamada exacta que se pasó + a set_error_handler para definirla. + + + + + &reftitle.examples; + + + Ejemplo de <function>get_error_handler</function> + + +]]> + + + + + + + &reftitle.notes; + + + Anteriormente a PHP 8.5.0, esta funcionalidad puede ser proporcionada por el + polyfill siguiente: + + + + +]]> + + + + + + + &reftitle.seealso; + + + error_reporting + set_error_handler + restore_error_handler + trigger_error + constante de nivel de error + + + + + diff --git a/reference/errorfunc/functions/get-exception-handler.xml b/reference/errorfunc/functions/get-exception-handler.xml new file mode 100644 index 000000000..606532512 --- /dev/null +++ b/reference/errorfunc/functions/get-exception-handler.xml @@ -0,0 +1,123 @@ + + + + + + get_exception_handler + Devuelve la función de gestión de excepciones definida por el usuario + + + + &reftitle.description; + + callablenullget_exception_handler + + + + Devuelve la función de gestión de excepciones definida por el usuario, si se ha definido alguna. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Devuelve la función de gestión de excepciones definida. + Si no se ha definido ninguna, se devuelve &null;. + + + El gestor devuelto es la función de retrollamada exacta que se pasó + a set_exception_handler para definirla. + + + + + &reftitle.examples; + + + Ejemplo de <function>get_exception_handler</function> + +getMessage() . "\n"; +}; + +var_dump(get_exception_handler()); // NULL + +set_exception_handler($handler); + +var_dump(get_exception_handler() === $handler); // bool(true) + +?> +]]> + + + + + + + &reftitle.notes; + + + Antes de PHP 8.5.0, esta funcionalidad podía ser proporcionada por el + polyfill siguiente: + + + + +]]> + + + + + + + &reftitle.seealso; + + + set_exception_handler + restore_exception_handler + restore_error_handler + error_reporting + Exceptions + + + + + diff --git a/reference/ftp/ftp.connection.xml b/reference/ftp/ftp.connection.xml new file mode 100644 index 000000000..4a7dc3928 --- /dev/null +++ b/reference/ftp/ftp.connection.xml @@ -0,0 +1,56 @@ + + + + + The FTP\Connection class + FTP\Connection + + + + +
+ &reftitle.intro; + + Una clase completamente opaca que reemplaza el &resource; + ftp a partir de PHP 8.1.0. + +
+ + +
+ &reftitle.classsynopsis; + + + + + final + FTP\Connection + + + + +
+ + + + + diff --git a/reference/ftp/functions/ftp-append.xml b/reference/ftp/functions/ftp-append.xml new file mode 100644 index 000000000..c246558e2 --- /dev/null +++ b/reference/ftp/functions/ftp-append.xml @@ -0,0 +1,107 @@ + + + + + + ftp_append + Añade el contenido de un fichero a otro fichero en el servidor FTP + + + + &reftitle.description; + + boolftp_append + FTP\Connectionftp + stringremote_filename + stringlocal_filename + intmodeFTP_BINARY + + + + + + &warn.undocumented.func; + + + + + &reftitle.parameters; + + + ftp + + &ftp.parameter.ftp; + + + + remote_filename + + + El nombre del fichero remoto al que se añadirá el contenido. + + + + + local_filename + + + El nombre del fichero local cuyo contenido se añadirá al fichero remoto. + + + + + mode + + + El modo de transferencia. Debe ser FTP_ASCII o FTP_BINARY. + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &ftp.changelog.ftp-param; + + + + + + + diff --git a/reference/ftp/functions/ftp-mlsd.xml b/reference/ftp/functions/ftp-mlsd.xml new file mode 100644 index 000000000..782a7a192 --- /dev/null +++ b/reference/ftp/functions/ftp-mlsd.xml @@ -0,0 +1,221 @@ + + + + + + ftp_mlsd + Devuelve la lista de ficheros de un directorio dado + + + &reftitle.description; + + arrayfalseftp_mlsd + FTP\Connectionftp + stringdirectory + + + + &reftitle.parameters; + + + + ftp + + &ftp.parameter.ftp; + + + + directory + + + El directorio a recorrer. + + + + + + + + &reftitle.returnvalues; + + Devuelve un array de arrays con la información de los ficheros del directorio especificado + en caso de éxito o &false; si hay un error. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &ftp.changelog.ftp-param; + + + + + + + &reftitle.examples; + + + Ejemplo con <function>ftp_mlsd</function> + + +]]> + + &example.outputs.similar; + + + array(8) { + ["name"]=> + string(1) "." + ["modify"]=> + string(14) "20171212154511" + ["perm"]=> + string(7) "flcdmpe" + ["type"]=> + string(4) "cdir" + ["unique"]=> + string(11) "811U5740002" + ["UNIX.group"]=> + string(2) "33" + ["UNIX.mode"]=> + string(4) "0755" + ["UNIX.owner"]=> + string(2) "33" + } + [1]=> + array(8) { + ["name"]=> + string(2) ".." + ["modify"]=> + string(14) "20171212154511" + ["perm"]=> + string(7) "flcdmpe" + ["type"]=> + string(4) "pdir" + ["unique"]=> + string(11) "811U5740002" + ["UNIX.group"]=> + string(2) "33" + ["UNIX.mode"]=> + string(4) "0755" + ["UNIX.owner"]=> + string(2) "33" + } + [2]=> + array(8) { + ["name"]=> + string(11) "public_html" + ["modify"]=> + string(14) "20171211171525" + ["perm"]=> + string(7) "flcdmpe" + ["type"]=> + string(3) "dir" + ["unique"]=> + string(11) "811U5740525" + ["UNIX.group"]=> + string(2) "33" + ["UNIX.mode"]=> + string(4) "0755" + ["UNIX.owner"]=> + string(2) "33" + } + [3]=> + array(8) { + ["name"]=> + string(10) "public_ftp" + ["modify"]=> + string(14) "20171211174536" + ["perm"]=> + string(7) "flcdmpe" + ["type"]=> + string(3) "dir" + ["unique"]=> + string(11) "811U57405EE" + ["UNIX.group"]=> + string(2) "33" + ["UNIX.mode"]=> + string(4) "0755" + ["UNIX.owner"]=> + string(2) "33" + } + [4]=> + array(8) { + ["name"]=> + string(3) "www" + ["modify"]=> + string(14) "www" + ["perm"]=> + string(7) "flcdmpe" + ["type"]=> + string(3) "dir" + ["unique"]=> + string(11) "811U5740780" + ["UNIX.group"]=> + string(2) "33" + ["UNIX.mode"]=> + string(4) "0755" + ["UNIX.owner"]=> + string(2) "33" + } +} +]]> + + + + + + &reftitle.seealso; + + + ftp_rawlist + ftp_nlist + + + + + diff --git a/reference/gearman/gearmanclient/wait.xml b/reference/gearman/gearmanclient/wait.xml new file mode 100644 index 000000000..6f01e887d --- /dev/null +++ b/reference/gearman/gearmanclient/wait.xml @@ -0,0 +1,62 @@ + + + + + + GearmanClient::wait + Espera la actividad de E/S en todas las conexiones de un cliente + + + + &reftitle.description; + + public boolGearmanClient::wait + + + + Esto espera la actividad de cualquiera de los servidores conectados. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + &true; en caso de éxito, &false; en caso de error. + + + + + &reftitle.seealso; + + + GearmanWorker::wait + + + + + + diff --git a/reference/gettext/functions/-.xml b/reference/gettext/functions/-.xml new file mode 100644 index 000000000..9d8e00224 --- /dev/null +++ b/reference/gettext/functions/-.xml @@ -0,0 +1,38 @@ + + + + + + _ + &Alias; gettext + + + + &reftitle.description; + + &info.function.alias; + gettext. + + + + + diff --git a/reference/gmp/functions/gmp-binomial.xml b/reference/gmp/functions/gmp-binomial.xml new file mode 100644 index 000000000..411461fd1 --- /dev/null +++ b/reference/gmp/functions/gmp-binomial.xml @@ -0,0 +1,102 @@ + + + + + + + gmp_binomial + Calcula el coeficiente binomial + + + + &reftitle.description; + + GMPgmp_binomial + GMPintstringn + intk + + + Calcula el coeficiente binomial C(n, k). + + + + + &reftitle.parameters; + + + + n + + &gmp.parameter; + + + + k + + + + + + + + + + + + &reftitle.returnvalues; + + Retorna el coeficiente binomial C(n, k). + + + + + &reftitle.errors; + + Lanza una ValueError si k es negativo. + Anterior a PHP 8.0.0, se emitía E_WARNING en su lugar. + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Esta función ya no retorna &false; en caso de fallo. + + + + + + + + + + diff --git a/reference/gmp/functions/gmp-kronecker.xml b/reference/gmp/functions/gmp-kronecker.xml new file mode 100644 index 000000000..2793407d5 --- /dev/null +++ b/reference/gmp/functions/gmp-kronecker.xml @@ -0,0 +1,78 @@ + + + + + + + gmp_kronecker + Símbolo Kronecker + + + + &reftitle.description; + + intgmp_kronecker + GMPintstringnum1 + GMPintstringnum2 + + + Esta función calcula el símbolo Kronecker de num1 y + num2. + + + + + &reftitle.parameters; + + + num1 + + &gmp.parameter; + + + + num2 + + &gmp.parameter; + + + + + + + &reftitle.returnvalues; + + Devuelve el símbolo Kronecker de num1 y + num2. + + + + + &reftitle.seealso; + + gmp_jacobi + gmp_legendre + + + + + diff --git a/reference/gmp/functions/gmp-lcm.xml b/reference/gmp/functions/gmp-lcm.xml new file mode 100644 index 000000000..e23acf066 --- /dev/null +++ b/reference/gmp/functions/gmp-lcm.xml @@ -0,0 +1,76 @@ + + + + + + + gmp_lcm + Calcula el Mínimo Común Múltiplo (MCM) + + + + &reftitle.description; + + GMPgmp_lcm + GMPintstringnum1 + GMPintstringnum2 + + + Esta función calcula el mínimo común múltiplo (MCM) de + num1 y num2. + + + + + &reftitle.parameters; + + + num1 + + &gmp.parameter; + + + + num2 + + &gmp.parameter; + + + + + + + &reftitle.returnvalues; + + &gmp.return; + + + + + &reftitle.seealso; + + gmp_gcd + + + + + diff --git a/reference/gmp/functions/gmp-perfect-power.xml b/reference/gmp/functions/gmp-perfect-power.xml new file mode 100644 index 000000000..c7a0b74e9 --- /dev/null +++ b/reference/gmp/functions/gmp-perfect-power.xml @@ -0,0 +1,68 @@ + + + + + + + gmp_perfect_power + Verifica si un número es una potencia perfecta + + + + &reftitle.description; + + boolgmp_perfect_power + GMPintstringnum + + + Verifica si num es una potencia perfecta. + + + + + &reftitle.parameters; + + + num + + &gmp.parameter; + + + + + + + &reftitle.returnvalues; + + Devuelve &true; si num es una potencia perfecta, &false; en caso contrario. + + + + + &reftitle.seealso; + + gmp_perfect_square + + + + + diff --git a/reference/gmp/functions/gmp-random-bits.xml b/reference/gmp/functions/gmp-random-bits.xml new file mode 100644 index 000000000..dc67ea2f5 --- /dev/null +++ b/reference/gmp/functions/gmp-random-bits.xml @@ -0,0 +1,106 @@ + + + + + + gmp_random_bits + Genera un número aleatorio + + + + &reftitle.description; + + GMPgmp_random_bits + intbits + + + Genera un número aleatorio. El número estará en el intervalo + 0 y + 2$bits - 1. + + + El argumento bits debe ser mayor que 0, + y el valor máximo estará restringido por la memoria disponible. + + &caution.cryptographically-insecure; + + + + &reftitle.parameters; + + + + bits + + + El número de bits a generar. + + + + + + + + + &reftitle.returnvalues; + + Un número GMP aleatorio. + + + + + &reftitle.errors; + + Si bits es menor que 1, + se lanzará una ValueError. + + + + + &reftitle.examples; + + + Ejemplo con <function>gmp_random_bits</function> + + +]]> + + &example.outputs; + + + + + + + + + diff --git a/reference/gmp/functions/gmp-random-range.xml b/reference/gmp/functions/gmp-random-range.xml new file mode 100644 index 000000000..c65e86d90 --- /dev/null +++ b/reference/gmp/functions/gmp-random-range.xml @@ -0,0 +1,119 @@ + + + + + + gmp_random_range + Obtener un entero seleccionado uniformemente + + + + &reftitle.description; + + GMPgmp_random_range + GMPintstringmin + GMPintstringmax + + + Genera un número aleatorio. El número estará en el intervalo + min y max. + + + min y max pueden ser ambos negativos, + pero min debe ser siempre inferior a max. + + &caution.cryptographically-insecure; + + + + &reftitle.parameters; + + + + min + + + Un número GMP que representa el límite inferior para el número aleatorio. + + + + + max + + + Un número GMP que representa el límite superior para el número aleatorio. + + + + + + + + + &reftitle.returnvalues; + + Un número GMP aleatorio. + Devuelve un objeto GMP que contiene un entero seleccionado uniformemente + en el intervalo cerrado + [min, max]. + min y max son + ambos valores de retorno posibles. + + + + + &reftitle.errors; + + Si max es inferior a min, + se lanzará una ValueError. + + + + + &reftitle.examples; + + + Ejemplo con <function>gmp_random_range</function> + + +]]> + + &example.outputs; + + + + + + + + + diff --git a/reference/gmp/gmp/construct.xml b/reference/gmp/gmp/construct.xml new file mode 100644 index 000000000..3a2a22152 --- /dev/null +++ b/reference/gmp/gmp/construct.xml @@ -0,0 +1,55 @@ + + + + + + GMP::__construct + Crea un número GMP + + + + &reftitle.description; + + public GMP::__construct + intstringnum0 + intbase0 + + + Crea un número GMP, a partir de un integer o de un string. + + + + + + + + + + + &reftitle.seealso; + + gmp_init + + + + + diff --git a/reference/gmp/gmp/serialize.xml b/reference/gmp/gmp/serialize.xml new file mode 100644 index 000000000..3e1b9c0cc --- /dev/null +++ b/reference/gmp/gmp/serialize.xml @@ -0,0 +1,56 @@ + + + + + + GMP::__serialize + Serializa el objeto GMP + + + + &reftitle.description; + + public arrayGMP::__serialize + + + + + + + &warn.undocumented.func; + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + &return.void; + + + + + diff --git a/reference/gmp/gmp/unserialize.xml b/reference/gmp/gmp/unserialize.xml new file mode 100644 index 000000000..6813eea85 --- /dev/null +++ b/reference/gmp/gmp/unserialize.xml @@ -0,0 +1,65 @@ + + + + + + GMP::__unserialize + Deserializa el argumento data en un objeto GMP + + + + &reftitle.description; + + public voidGMP::__unserialize + arraydata + + + + + + &warn.undocumented.func; + + + + + &reftitle.parameters; + + + data + + + El valor en curso de deserialización. + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + diff --git a/reference/gnupg/functions/gnupg-deletekey.xml b/reference/gnupg/functions/gnupg-deletekey.xml new file mode 100644 index 000000000..4aa0f19f0 --- /dev/null +++ b/reference/gnupg/functions/gnupg-deletekey.xml @@ -0,0 +1,105 @@ + + + + + + gnupg_deletekey + Elimina una clave del llavero + + + + &reftitle.description; + + boolgnupg_deletekey + resourceidentifier + stringkey + boolallow_secret + + + + + &reftitle.parameters; + + + + identifier + + &gnupg.identifier; + + + + key + + + La clave a eliminar. + + + + + allow_secret + + + Especifica si se deben eliminar las claves secretas. + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.examples; + + + Ejemplo procedimental <function>gnupg_deletekey</function> + + +]]> + + + + Ejemplo orientado a objetos <function>gnupg_deletekey</function> + +deletekey("8660281B6051D071D94B5B230549F9DC851566DC"); +?> +]]> + + + + + + + diff --git a/reference/gnupg/functions/gnupg-getengineinfo.xml b/reference/gnupg/functions/gnupg-getengineinfo.xml new file mode 100644 index 000000000..778010e8f --- /dev/null +++ b/reference/gnupg/functions/gnupg-getengineinfo.xml @@ -0,0 +1,114 @@ + + + + + + gnupg_getengineinfo + Devuelve la información del motor + + + + &reftitle.description; + + arraygnupg_getengineinfo + resourceidentifier + + + + + &reftitle.parameters; + + + + identifier + + &gnupg.identifier; + + + + + + + + &reftitle.returnvalues; + + Devuelve un array que contiene la información del motor compuesto por protocol, + file_name y home_dir. + + + + + &reftitle.examples; + + + Ejemplo procedimental <function>gnupg_getengineinfo</function> + + +]]> + + &example.outputs; + + + int(0) + ["file_name"]=> + string(12) "/usr/bin/gpg" + ["home_dir"]=> + string(0) "" +} +]]> + + + + Ejemplo orientado a objetos <function>gnupg_getengineinfo</function> + + "/usr/bin/gpg2", "home_dir" => "/var/www/.gnupg"]); +print_r($gpg->getengineinfo()); +?> +]]> + + &example.outputs; + + + int(0) + ["file_name"]=> + string(13) "/usr/bin/gpg2" + ["home_dir"]=> + string(15) "/var/www/.gnupg" +} +]]> + + + + + + + diff --git a/reference/gnupg/functions/gnupg-geterrorinfo.xml b/reference/gnupg/functions/gnupg-geterrorinfo.xml new file mode 100644 index 000000000..bf201fc15 --- /dev/null +++ b/reference/gnupg/functions/gnupg-geterrorinfo.xml @@ -0,0 +1,121 @@ + + + + + + gnupg_geterrorinfo + Devuelve la información de error + + + + &reftitle.description; + + arraygnupg_geterrorinfo + resourceidentifier + + + + + &reftitle.parameters; + + + + identifier + + &gnupg.identifier; + + + + + + + + &reftitle.returnvalues; + + Devuelve un array con la información de error. + + + + + &reftitle.examples; + + + Ejemplo procedimental <function>gnupg_geterrorinfo</function> + + +]]> + + &example.outputs; + + + bool(false) + ["gpgme_code"]=> + int(0) + ["gpgme_source"]=> + string(18) "Unspecified source" + ["gpgme_message"]=> + string(7) "Success" +} +]]> + + + + Ejemplo orientado a objetos <function>gnupg_geterrorinfo</function> + +decrypt('abc'); +// la información de error debe ser mostrada +print_r($gpg->geterrorinfo()); +?> +]]> + + &example.outputs; + + + string(14) "decrypt failed" + ["gpgme_code"]=> + int(117440570) + ["gpgme_source"]=> + string(5) "GPGME" + ["gpgme_message"]=> + string(7) "No data" +} +]]> + + + + + + + diff --git a/reference/gnupg/functions/gnupg-gettrustlist.xml b/reference/gnupg/functions/gnupg-gettrustlist.xml new file mode 100644 index 000000000..25eaafd1a --- /dev/null +++ b/reference/gnupg/functions/gnupg-gettrustlist.xml @@ -0,0 +1,99 @@ + + + + + + gnupg_gettrustlist + Busca los elementos de confianza + + + + &reftitle.description; + + arraynullgnupg_gettrustlist + resourceidentifier + stringpattern + + + + + &reftitle.parameters; + + + + identifier + + &gnupg.identifier; + + + + pattern + + + Una expresión para limitar la lista de elementos de confianza a los elementos que coinciden con el patrón. + + + + + + + + + &reftitle.returnvalues; + + En caso de éxito, esta función devuelve un array de elementos de confianza. + En caso de error, esta función devuelve &null;. + + + + + &reftitle.examples; + + + Ejemplo procedimental <function>gnupg_gettrustlist</function> + + +]]> + + + + Ejemplo orientado a objetos <function>gnupg_gettrustlist</function> + +gettrustlist(); +print_r($items); +?> +]]> + + + + + + + diff --git a/reference/gnupg/functions/gnupg-listsignatures.xml b/reference/gnupg/functions/gnupg-listsignatures.xml new file mode 100644 index 000000000..b4ab6013c --- /dev/null +++ b/reference/gnupg/functions/gnupg-listsignatures.xml @@ -0,0 +1,99 @@ + + + + + + gnupg_listsignatures + Lista las firmas de clave + + + + &reftitle.description; + + arraynullgnupg_listsignatures + resourceidentifier + stringkeyid + + + + + &reftitle.parameters; + + + + identifier + + &gnupg.identifier; + + + + keyid + + + El identificador de clave para listar las firmas. + + + + + + + + + &reftitle.returnvalues; + + En caso de éxito, esta función devuelve un array de firmas de clave. + En caso de error, esta función devuelve &null;. + + + + + &reftitle.examples; + + + Ejemplo procedimental <function>gnupg_listsignatures</function> + + +]]> + + + + Ejemplo orientado a objetos <function>gnupg_listsignatures</function> + +listsignatures("8660281B6051D071D94B5B230549F9DC851566DC"); +print_r($signatures); +?> +]]> + + + + + + + diff --git a/reference/hash/functions/hash-hkdf.xml b/reference/hash/functions/hash-hkdf.xml new file mode 100644 index 000000000..90bc1fbc8 --- /dev/null +++ b/reference/hash/functions/hash-hkdf.xml @@ -0,0 +1,189 @@ + + + + + + + hash_hkdf + Genera una derivación de clave HKDF desde una clave proporcionada + + + &reftitle.description; + + stringhash_hkdf + stringalgo + #[\SensitiveParameter]stringkey + intlength0 + stringinfo"" + stringsalt"" + + + + + &reftitle.parameters; + + + + algo + + + Nombre del algoritmo de hash seleccionado (por ejemplo: "sha256"). + Para una lista de los algoritmos soportados ver hash_hmac_algos. + + + Las funciones de hash no criptográficas no están permitidas. + + + + + + + key + + + Datos (Input keying material) en binario que servirán para el clavetage. + No puede estar vacío. + + + + + length + + + Longitud deseada de los datos de salida en octetos. + No puede ser mayor que 255 veces el tamaño de la función de hash. + + + Si length vale 0, la longitud de los + datos de salida será por defecto el tamaño de la función de hash elegida. + + + + + info + + + Información en forma de &string; específica de la aplicación/contexto. + + + + + salt + + + Sal a utilizar durante la derivación. + + + Aunque opcional, añadir una sal aleatoria aumenta significativamente la + robustez de HKDF. + + + + + + + + + &reftitle.returnvalues; + + Devuelve un &string; que contiene una representación binaria en bruto de la clave derivada + (también conocida como output keying material - OKM). + + + + + &reftitle.errors; + + Lanza una excepción ValueError si key + está vacío, algo es desconocido/no criptográfico, + length es menor que 0 o demasiado grande + (mayor que 255 veces el tamaño de la función de hash). + + + + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 8.0.0 + + Lanza una excepción ValueError en caso de error a partir de ahora. + Anteriormente, se devolvía &false; y se emitía un mensaje E_WARNING. + + + + + + + + + + &reftitle.examples; + + + Ejemplo con <function>hash_hkdf</function> + + +]]> + + + El ejemplo anterior produce un par de claves separadas, que es adecuado para crear + una construcción cifrar-entonces-HMAC (encrypt-then-HMAC), utilizando AES-256 + y SHA-256 para el cifrado y la autenticación respectivamente. + + + + + + + &reftitle.seealso; + + + hash_pbkdf2 + RFC 5869 + implementación en userland + + + + + + diff --git a/reference/hash/functions/hash-hmac-algos.xml b/reference/hash/functions/hash-hmac-algos.xml new file mode 100644 index 000000000..00b9aeb70 --- /dev/null +++ b/reference/hash/functions/hash-hmac-algos.xml @@ -0,0 +1,138 @@ + + + + + + + + hash_hmac_algos + Devuelve una lista de algoritmos de hash registrados adecuados para hash_hmac + + + + &reftitle.description; + + arrayhash_hmac_algos + + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Devuelve un array indexado numéricamente que contiene la lista de todos los + algoritmos de hash disponibles que son adecuados para hash_hmac. + + + + + &reftitle.examples; + + Ejemplo con <function>hash_hmac_algos</function> + + + + &example.outputs.similar; + + md2 + [1] => md4 + [2] => md5 + [3] => sha1 + [4] => sha224 + [5] => sha256 + [6] => sha384 + [7] => sha512/224 + [8] => sha512/256 + [9] => sha512 + [10] => sha3-224 + [11] => sha3-256 + [12] => sha3-384 + [13] => sha3-512 + [14] => ripemd128 + [15] => ripemd160 + [16] => ripemd256 + [17] => ripemd320 + [18] => whirlpool + [19] => tiger128,3 + [20] => tiger160,3 + [21] => tiger192,3 + [22] => tiger128,4 + [23] => tiger160,4 + [24] => tiger192,4 + [25] => snefru + [26] => snefru256 + [27] => gost + [28] => gost-crypto + [29] => haval128,3 + [30] => haval160,3 + [31] => haval192,3 + [32] => haval224,3 + [33] => haval256,3 + [34] => haval128,4 + [35] => haval160,4 + [36] => haval192,4 + [37] => haval224,4 + [38] => haval256,4 + [39] => haval128,5 + [40] => haval160,5 + [41] => haval192,5 + [42] => haval224,5 + [43] => haval256,5 +) +]]> + + + + + + &reftitle.notes; + + + Antes de PHP 7.2.0 la única forma de recuperar una lista de los algoritmos disponibles + era llamar a hash_algos que también devolvía + algoritmos que no son adecuados para hash_hmac. + + + + + + &reftitle.seealso; + + hash_hmac + hash_algos + + + + + + diff --git a/reference/hash/hashcontext.xml b/reference/hash/hashcontext.xml new file mode 100644 index 000000000..c72d8c227 --- /dev/null +++ b/reference/hash/hashcontext.xml @@ -0,0 +1,67 @@ + + + + + + La clase HashContext + HashContext + + + + +
+ &reftitle.intro; + + + +
+ + +
+ &reftitle.classsynopsis; + + + + + final + HashContext + + + &Methods; + + + + + + + + + +
+ + + + &reference.hash.entities.hashcontext; + + + + diff --git a/reference/hash/hashcontext/construct.xml b/reference/hash/hashcontext/construct.xml new file mode 100644 index 000000000..197f5a8b9 --- /dev/null +++ b/reference/hash/hashcontext/construct.xml @@ -0,0 +1,43 @@ + + + + + + HashContext::__construct + Constructor privado para prohibir la instanciación directa + + + + &reftitle.description; + + private HashContext::__construct + + + + + + &reftitle.parameters; + &no.function.parameters; + + + + diff --git a/reference/hash/hashcontext/serialize.xml b/reference/hash/hashcontext/serialize.xml new file mode 100644 index 000000000..6a302efe1 --- /dev/null +++ b/reference/hash/hashcontext/serialize.xml @@ -0,0 +1,56 @@ + + + + + + HashContext::__serialize + Serializa el objeto HashContext + + + + &reftitle.description; + + public arrayHashContext::__serialize + + + + + + + &warn.undocumented.func; + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + &return.void; + + + + + diff --git a/reference/hash/hashcontext/unserialize.xml b/reference/hash/hashcontext/unserialize.xml new file mode 100644 index 000000000..025854d36 --- /dev/null +++ b/reference/hash/hashcontext/unserialize.xml @@ -0,0 +1,65 @@ + + + + + + HashContext::__unserialize + Deserializa el parámetro data en un objeto HashContext + + + + &reftitle.description; + + public voidHashContext::__unserialize + arraydata + + + + + + &warn.undocumented.func; + + + + + &reftitle.parameters; + + + data + + + El valor que se está deserializando. + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + diff --git a/reference/rpminfo/book.xml b/reference/rpminfo/book.xml new file mode 100644 index 000000000..728e41b65 --- /dev/null +++ b/reference/rpminfo/book.xml @@ -0,0 +1,46 @@ + + + + + + RpmInfo + RpmInfo + + + &reftitle.intro; + + Esta extensión permite recuperar información a partir de ficheros RPM + o de la base de datos de los RPM instalados. + + + Asimismo proporciona una envoltura de flujo rpm para recuperar el contenido de los RPM + (desde la versión 1.0.0 con librpm >= 4.13). + + + + &reference.rpminfo.setup; + &reference.rpminfo.constants; + &reference.rpminfo.reference; + + + + diff --git a/reference/rpminfo/constants.xml b/reference/rpminfo/constants.xml new file mode 100644 index 000000000..693f2eb3b --- /dev/null +++ b/reference/rpminfo/constants.xml @@ -0,0 +1,2936 @@ + + + + + &reftitle.constants; + &extension.constants; + + + Constantes diversas + + + RPMVERSION + (string) + + + + La versión de la biblioteca RPM. + + + + + + + RPM Senses + + + RPMSENSE_ANY + (int) + + + + + + + + + RPMSENSE_LESS + (int) + + + + + + + + + RPMSENSE_GREATER + (int) + + + + + + + + + RPMSENSE_EQUAL + (int) + + + + + + + + + RPMSENSE_POSTTRANS + (int) + + + + + + + + + RPMSENSE_PREREQ + (int) + + + + + + + + + RPMSENSE_PRETRANS + (int) + + + + + + + + + RPMSENSE_INTERP + (int) + + + + + + + + + RPMSENSE_SCRIPT_PRE + (int) + + + + + + + + + RPMSENSE_SCRIPT_POST + (int) + + + + + + + + + RPMSENSE_SCRIPT_PREUN + (int) + + + + + + + + + RPMSENSE_SCRIPT_POSTUN + (int) + + + + + + + + + RPMSENSE_SCRIPT_VERIFY + (int) + + + + + + + + + RPMSENSE_FIND_REQUIRES + (int) + + + + + + + + + RPMSENSE_FIND_PROVIDES + (int) + + + + + + + + + RPMSENSE_TRIGGERIN + (int) + + + + + + + + + RPMSENSE_TRIGGERUN + (int) + + + + + + + + + RPMSENSE_TRIGGERPOSTUN + (int) + + + + + + + + + RPMSENSE_MISSINGOK + (int) + + + + + + + + + RPMSENSE_RPMLIB + (int) + + + + + + + + + RPMSENSE_TRIGGERPREIN + (int) + + + + + + + + + RPMSENSE_KEYRING + (int) + + + + + + + + + RPMSENSE_CONFIG + (int) + + + + + + + + + + RPM Mire + + + RPMMIRE_DEFAULT + (int) + + + + Modelo de búsqueda en una expresión regular con + \., .*, + y ^...$ añadidos. + + + + + + RPMMIRE_STRCMP + (int) + + + + El modelo de búsqueda es una string, + utilizando strcmp(3). + + + + + + RPMMIRE_REGEX + (int) + + + + El modelo de búsqueda es una expresión regular, + utilizando regcomp(3). + + + + + + RPMMIRE_GLOB + (int) + + + + El modelo de búsqueda es una expresión global, + utilizando fnmatch(3). + + + + + + + RPM tags + + + RPMTAG_ARCH + (int) + + + + + + + + + RPMTAG_ARCHSUFFIX + (int) + + + + Requiere librpm >= 4.18 + + + + + + RPMTAG_ARCHIVESIZE + (int) + + + + + + + + + RPMTAG_BASENAMES + (int) + + + + El nombre (no la ruta) de los ficheros, con el índice de la base de datos. + + + + + + RPMTAG_BUGURL + (int) + + + + + + + + + RPMTAG_BUILDARCHS + (int) + + + + + + + + + RPMTAG_BUILDHOST + (int) + + + + + + + + + RPMTAG_BUILDTIME + (int) + + + + + + + + + RPMTAG_C + (int) + + + + + + + + + RPMTAG_CHANGELOGNAME + (int) + + + + + + + + + RPMTAG_CHANGELOGTEXT + (int) + + + + + + + + + RPMTAG_CHANGELOGTIME + (int) + + + + + + + + + RPMTAG_CLASSDICT + (int) + + + + + + + + + RPMTAG_CONFLICTFLAGS + (int) + + + + + + + + + RPMTAG_CONFLICTNAME + (int) + + + + Dependencias conflictivas, con el índice de la base de datos. + + + + + + RPMTAG_CONFLICTNEVRS + (int) + + + + + + + + + RPMTAG_CONFLICTS + (int) + + + + + + + + + RPMTAG_CONFLICTVERSION + (int) + + + + + + + + + RPMTAG_COOKIE + (int) + + + + + + + + + RPMTAG_DBINSTANCE + (int) + + + + + + + + + RPMTAG_DEPENDSDICT + (int) + + + + + + + + + RPMTAG_DESCRIPTION + (int) + + + + + + + + + RPMTAG_DIRINDEXES + (int) + + + + + + + + + RPMTAG_DIRNAMES + (int) + + + + El directorio de los ficheros, con el índice de la base de datos. + + + + + + RPMTAG_DISTRIBUTION + (int) + + + + + + + + + RPMTAG_DISTTAG + (int) + + + + + + + + + RPMTAG_DISTURL + (int) + + + + + + + + + RPMTAG_DSAHEADER + (int) + + + + + + + + + RPMTAG_E + (int) + + + + + + + + + RPMTAG_ENCODING + (int) + + + + + + + + + RPMTAG_ENHANCEFLAGS + (int) + + + + + + + + + RPMTAG_ENHANCENAME + (int) + + + + Dependencia débil, con el índice de la base de datos, requiere librpm >= 4.13. + + + + + + RPMTAG_ENHANCENEVRS + (int) + + + + + + + + + RPMTAG_ENHANCES + (int) + + + + + + + + + RPMTAG_ENHANCEVERSION + (int) + + + + + + + + + RPMTAG_EPOCH + (int) + + + + + + + + + RPMTAG_EPOCHNUM + (int) + + + + + + + + + RPMTAG_EVR + (int) + + + + + + + + + RPMTAG_EXCLUDEARCH + (int) + + + + + + + + + RPMTAG_EXCLUDEOS + (int) + + + + + + + + + RPMTAG_EXCLUSIVEARCH + (int) + + + + + + + + + RPMTAG_EXCLUSIVEOS + (int) + + + + + + + + + RPMTAG_FILECAPS + (int) + + + + + + + + + RPMTAG_FILECLASS + (int) + + + + + + + + + RPMTAG_FILECOLORS + (int) + + + + + + + + + RPMTAG_FILECONTEXTS + (int) + + + + + + + + + RPMTAG_FILEDEPENDSN + (int) + + + + + + + + + RPMTAG_FILEDEPENDSX + (int) + + + + + + + + + RPMTAG_FILEDEVICES + (int) + + + + + + + + + RPMTAG_FILEDIGESTALGO + (int) + + + + + + + + + RPMTAG_FILEDIGESTS + (int) + + + + + + + + + RPMTAG_FILEFLAGS + (int) + + + + + + + + + RPMTAG_FILEGROUPNAME + (int) + + + + + + + + + RPMTAG_FILEINODES + (int) + + + + + + + + + RPMTAG_FILELANGS + (int) + + + + + + + + + RPMTAG_FILELINKTOS + (int) + + + + + + + + + RPMTAG_FILEMD5S + (int) + + + + + + + + + RPMTAG_FILEMODES + (int) + + + + + + + + + RPMTAG_FILEMTIMES + (int) + + + + + + + + + RPMTAG_FILENAMES + (int) + + + + + + + + + RPMTAG_FILENLINKS + (int) + + + + + + + + + RPMTAG_FILEPROVIDE + (int) + + + + + + + + + RPMTAG_FILERDEVS + (int) + + + + + + + + + RPMTAG_FILEREQUIRE + (int) + + + + + + + + + RPMTAG_FILESIGNATURELENGTH + (int) + + + + + + + + + RPMTAG_FILESIGNATURES + (int) + + + + + + + + + RPMTAG_FILESIZES + (int) + + + + + + + + + RPMTAG_FILESTATES + (int) + + + + + + + + + RPMTAG_FILETRIGGERCONDS + (int) + + + + + + + + + RPMTAG_FILETRIGGERFLAGS + (int) + + + + + + + + + RPMTAG_FILETRIGGERINDEX + (int) + + + + + + + + + RPMTAG_FILETRIGGERNAME + (int) + + + + El nombre del fichero desencadenante, con el índice de la base de datos, requiere librpm >= 4.13. + + + + + + RPMTAG_FILETRIGGERPRIORITIES + (int) + + + + + + + + + RPMTAG_FILETRIGGERSCRIPTFLAGS + (int) + + + + + + + + + RPMTAG_FILETRIGGERSCRIPTPROG + (int) + + + + + + + + + RPMTAG_FILETRIGGERSCRIPTS + (int) + + + + + + + + + RPMTAG_FILETRIGGERTYPE + (int) + + + + + + + + + RPMTAG_FILETRIGGERVERSION + (int) + + + + + + + + + RPMTAG_FILEUSERNAME + (int) + + + + + + + + + RPMTAG_FILEVERIFYFLAGS + (int) + + + + + + + + + RPMTAG_FSCONTEXTS + (int) + + + + + + + + + RPMTAG_GIF + (int) + + + + + + + + + RPMTAG_GROUP + (int) + + + + El grupo de paquete, con el índice de la base de datos. + + + + + + RPMTAG_HDRID + (int) + + + + + + + + + RPMTAG_HEADERCOLOR + (int) + + + + + + + + + RPMTAG_HEADERI18NTABLE + (int) + + + + + + + + + RPMTAG_HEADERIMAGE + (int) + + + + + + + + + RPMTAG_HEADERIMMUTABLE + (int) + + + + + + + + + RPMTAG_HEADERREGIONS + (int) + + + + + + + + + RPMTAG_HEADERSIGNATURES + (int) + + + + + + + + + RPMTAG_ICON + (int) + + + + + + + + + RPMTAG_INSTALLCOLOR + (int) + + + + + + + + + RPMTAG_INSTALLTID + (int) + + + + El identificador de transacción de instalación, con el índice de la base de datos. + + + + + + RPMTAG_INSTALLTIME + (int) + + + + + + + + + RPMTAG_INSTFILENAMES + (int) + + + + La ruta de los ficheros, con el índice de la base de datos. + + + + + + RPMTAG_INSTPREFIXES + (int) + + + + + + + + + RPMTAG_LICENSE + (int) + + + + + + + + + RPMTAG_LONGARCHIVESIZE + (int) + + + + + + + + + RPMTAG_LONGFILESIZES + (int) + + + + + + + + + RPMTAG_LONGSIGSIZE + (int) + + + + + + + + + RPMTAG_LONGSIZE + (int) + + + + + + + + + RPMTAG_MODULARITYLABEL + (int) + + + + + + + + + RPMTAG_N + (int) + + + + + + + + + RPMTAG_NAME + (int) + + + + El nombre del paquete, con el índice de la base de datos. + + + + + + RPMTAG_NEVR + (int) + + + + + + + + + RPMTAG_NEVRA + (int) + + + + + + + + + RPMTAG_NOPATCH + (int) + + + + + + + + + RPMTAG_NOSOURCE + (int) + + + + + + + + + RPMTAG_NVR + (int) + + + + + + + + + RPMTAG_NVRA + (int) + + + + + + + + + RPMTAG_O + (int) + + + + + + + + + RPMTAG_OBSOLETEFLAGS + (int) + + + + + + + + + RPMTAG_OBSOLETENAME + (int) + + + + Paquete obsoleto, con el índice de la base de datos. + + + + + + RPMTAG_OBSOLETENEVRS + (int) + + + + + + + + + RPMTAG_OBSOLETES + (int) + + + + + + + + + RPMTAG_OBSOLETEVERSION + (int) + + + + + + + + + RPMTAG_OLDENHANCES + (int) + + + + + + + + + RPMTAG_OLDENHANCESFLAGS + (int) + + + + + + + + + RPMTAG_OLDENHANCESNAME + (int) + + + + + + + + + RPMTAG_OLDENHANCESVERSION + (int) + + + + + + + + + RPMTAG_OLDFILENAMES + (int) + + + + + + + + + RPMTAG_OLDSUGGESTS + (int) + + + + + + + + + RPMTAG_OLDSUGGESTSFLAGS + (int) + + + + + + + + + RPMTAG_OLDSUGGESTSNAME + (int) + + + + + + + + + RPMTAG_OLDSUGGESTSVERSION + (int) + + + + + + + + + RPMTAG_OPTFLAGS + (int) + + + + + + + + + RPMTAG_ORDERFLAGS + (int) + + + + + + + + + RPMTAG_ORDERNAME + (int) + + + + + + + + + RPMTAG_ORDERVERSION + (int) + + + + + + + + + RPMTAG_ORIGBASENAMES + (int) + + + + + + + + + RPMTAG_ORIGDIRINDEXES + (int) + + + + + + + + + RPMTAG_ORIGDIRNAMES + (int) + + + + + + + + + RPMTAG_ORIGFILENAMES + (int) + + + + + + + + + RPMTAG_OS + (int) + + + + + + + + + RPMTAG_P + (int) + + + + + + + + + RPMTAG_PACKAGER + (int) + + + + + + + + + RPMTAG_PATCH + (int) + + + + + + + + + RPMTAG_PATCHESFLAGS + (int) + + + + + + + + + RPMTAG_PATCHESNAME + (int) + + + + + + + + + RPMTAG_PATCHESVERSION + (int) + + + + + + + + + RPMTAG_PAYLOADCOMPRESSOR + (int) + + + + + + + + + RPMTAG_PAYLOADDIGEST + (int) + + + + + + + + + RPMTAG_PAYLOADDIGESTALT + (int) + + + + Con librpm >= 4.16. + + + + + + RPMTAG_PAYLOADDIGESTALGO + (int) + + + + + + + + + RPMTAG_PAYLOADFLAGS + (int) + + + + + + + + + RPMTAG_PAYLOADFORMAT + (int) + + + + + + + + + RPMTAG_PKGID + (int) + + + + + + + + + RPMTAG_PLATFORM + (int) + + + + + + + + + RPMTAG_POLICIES + (int) + + + + + + + + + RPMTAG_POLICYFLAGS + (int) + + + + + + + + + RPMTAG_POLICYNAMES + (int) + + + + + + + + + RPMTAG_POLICYTYPES + (int) + + + + + + + + + RPMTAG_POLICYTYPESINDEXES + (int) + + + + + + + + + RPMTAG_POSTIN + (int) + + + + + + + + + RPMTAG_POSTINFLAGS + (int) + + + + + + + + + RPMTAG_POSTINPROG + (int) + + + + + + + + + RPMTAG_POSTTRANS + (int) + + + + + + + + + RPMTAG_POSTTRANSFLAGS + (int) + + + + + + + + + RPMTAG_POSTTRANSPROG + (int) + + + + + + + + + RPMTAG_POSTUN + (int) + + + + + + + + + RPMTAG_POSTUNFLAGS + (int) + + + + + + + + + RPMTAG_POSTUNPROG + (int) + + + + + + + + + RPMTAG_POSTUNTRANS + (int) + + + + Requiere librpm >= 4.19 + + + + + + RPMTAG_POSTUNTRANSFLAGS + (int) + + + + Requiere librpm >= 4.19 + + + + + + RPMTAG_POSTUNTRANSPROG + (int) + + + + Requiere librpm >= 4.19 + + + + + + RPMTAG_PREFIXES + (int) + + + + + + + + + RPMTAG_PREIN + (int) + + + + + + + + + RPMTAG_PREINFLAGS + (int) + + + + + + + + + RPMTAG_PREINPROG + (int) + + + + + + + + + RPMTAG_PRETRANS + (int) + + + + + + + + + RPMTAG_PRETRANSFLAGS + (int) + + + + + + + + + RPMTAG_PRETRANSPROG + (int) + + + + + + + + + RPMTAG_PREUN + (int) + + + + + + + + + RPMTAG_PREUNFLAGS + (int) + + + + + + + + + RPMTAG_PREUNPROG + (int) + + + + + + + + + RPMTAG_PREUNTRANS + (int) + + + + Requiere librpm >= 4.19 + + + + + + RPMTAG_PREUNTRANSFLAGS + (int) + + + + Requiere librpm >= 4.19 + + + + + + RPMTAG_PREUNTRANSPROG + (int) + + + + Requiere librpm >= 4.19 + + + + + + RPMTAG_PROVIDEFLAGS + (int) + + + + + + + + + RPMTAG_PROVIDENAME + (int) + + + + Las dependencias proporcionadas, con el índice de la base de datos. + + + + + + RPMTAG_PROVIDENEVRS + (int) + + + + + + + + + RPMTAG_PROVIDES + (int) + + + + + + + + + RPMTAG_PROVIDEVERSION + (int) + + + + + + + + + RPMTAG_PUBKEYS + (int) + + + + + + + + + RPMTAG_R + (int) + + + + + + + + + RPMTAG_RECOMMENDFLAGS + (int) + + + + + + + + + RPMTAG_RECOMMENDNAME + (int) + + + + Las dependencias débiles recomendadas, con el índice de la base de datos, requiere librpm >= 4.13. + + + + + + RPMTAG_RECOMMENDNEVRS + (int) + + + + + + + + + RPMTAG_RECOMMENDS + (int) + + + + + + + + + RPMTAG_RECOMMENDVERSION + (int) + + + + + + + + + RPMTAG_RECONTEXTS + (int) + + + + + + + + + RPMTAG_RELEASE + (int) + + + + + + + + + RPMTAG_REMOVETID + (int) + + + + + + + + + RPMTAG_REQUIREFLAGS + (int) + + + + + + + + + RPMTAG_REQUIRENAME + (int) + + + + Las dependencias requeridas, con el índice de la base de datos. + + + + + + RPMTAG_REQUIRENEVRS + (int) + + + + + + + + + RPMTAG_REQUIRES + (int) + + + + + + + + + RPMTAG_REQUIREVERSION + (int) + + + + + + + + + RPMTAG_RPMVERSION + (int) + + + + + + + + + RPMTAG_RSAHEADER + (int) + + + + + + + + + RPMTAG_SHA1HEADER + (int) + + + + La firma SHA1, con el índice de la base de datos. + + + + + + RPMTAG_SHA256HEADER + (int) + + + + + + + + + RPMTAG_SIGGPG + (int) + + + + + + + + + RPMTAG_SIGMD5 + (int) + + + + La firma MD5, con el índice de la base de datos. + + + + + + RPMTAG_SIGPGP + (int) + + + + + + + + + RPMTAG_SIGSIZE + (int) + + + + + + + + + RPMTAG_SIZE + (int) + + + + + + + + + RPMTAG_SOURCE + (int) + + + + + + + + + RPMTAG_SOURCEPACKAGE + (int) + + + + + + + + + RPMTAG_SOURCEPKGID + (int) + + + + + + + + + RPMTAG_SOURCERPM + (int) + + + + + + + + + RPMTAG_SPEC + (int) + + + + Requiere librpm >= 4.18 + + + + + + RPMTAG_SUGGESTFLAGS + (int) + + + + + + + + + RPMTAG_SUGGESTNAME + (int) + + + + El directorio de los ficheros, con el índice de la base de datos. + + + + + + RPMTAG_SUGGESTNEVRS + (int) + + + + + + + + + RPMTAG_SUGGESTS + (int) + + + + + + + + + RPMTAG_SUGGESTVERSION + (int) + + + + + + + + + RPMTAG_SUMMARY + (int) + + + + + + + + + RPMTAG_SUPPLEMENTFLAGS + (int) + + + + + + + + + RPMTAG_SUPPLEMENTNAME + (int) + + + + Las dependencias débiles, con el índice de la base de datos, requiere librpm >= 4.13. + + + + + + RPMTAG_SUPPLEMENTNEVRS + (int) + + + + + + + + + RPMTAG_SUPPLEMENTS + (int) + + + + + + + + + RPMTAG_SUPPLEMENTVERSION + (int) + + + + + + + + + RPMTAG_SYSUSERS + (int) + + + + Requiere librpm >= 4.19 + + + + + + RPMTAG_TRANSFILETRIGGERCONDS + (int) + + + + + + + + + RPMTAG_TRANSFILETRIGGERFLAGS + (int) + + + + + + + + + RPMTAG_TRANSFILETRIGGERINDEX + (int) + + + + + + + + + RPMTAG_TRANSFILETRIGGERNAME + (int) + + + + El nombre del desencadenador de fichero de transacción, con el índice de la base de datos, requiere librpm >= 4.13. + + + + + + RPMTAG_TRANSFILETRIGGERPRIORITIES + (int) + + + + + + + + + RPMTAG_TRANSFILETRIGGERSCRIPTFLAGS + (int) + + + + + + + + + RPMTAG_TRANSFILETRIGGERSCRIPTPROG + (int) + + + + + + + + + RPMTAG_TRANSFILETRIGGERSCRIPTS + (int) + + + + + + + + + RPMTAG_TRANSFILETRIGGERTYPE + (int) + + + + + + + + + RPMTAG_TRANSFILETRIGGERVERSION + (int) + + + + + + + + + RPMTAG_TRANSLATIONURL + (int) + + + + Requiere librpm >= 4.18 + + + + + + RPMTAG_TRIGGERCONDS + (int) + + + + + + + + + RPMTAG_TRIGGERFLAGS + (int) + + + + + + + + + RPMTAG_TRIGGERINDEX + (int) + + + + + + + + + RPMTAG_TRIGGERNAME + (int) + + + + El nombre del desencadenador, con el índice de la base de datos. + + + + + + RPMTAG_TRIGGERSCRIPTFLAGS + (int) + + + + + + + + + RPMTAG_TRIGGERSCRIPTPROG + (int) + + + + + + + + + RPMTAG_TRIGGERSCRIPTS + (int) + + + + + + + + + RPMTAG_TRIGGERTYPE + (int) + + + + + + + + + RPMTAG_TRIGGERVERSION + (int) + + + + + + + + + RPMTAG_UPSTREAMRELEASES + (int) + + + + Requiere librpm >= 4.18 + + + + + + RPMTAG_URL + (int) + + + + + + + + + RPMTAG_V + (int) + + + + + + + + + RPMTAG_VCS + (int) + + + + + + + + + RPMTAG_VENDOR + (int) + + + + + + + + + RPMTAG_VERBOSE + (int) + + + + + + + + + RPMTAG_VERIFYSCRIPT + (int) + + + + + + + + + RPMTAG_VERIFYSCRIPTFLAGS + (int) + + + + + + + + + RPMTAG_VERIFYSCRIPTPROG + (int) + + + + + + + + + RPMTAG_VERITYSIGNATUREALGO + (int) + + + + Con librpm >= 4.17. + + + + + + RPMTAG_VERITYSIGNATURES + (int) + + + + Con librpm >= 4.17. + + + + + + RPMTAG_VERSION + (int) + + + + + + + + + RPMTAG_XPM + (int) + + + + + + + + + diff --git a/reference/rpminfo/functions/rpmaddtag.xml b/reference/rpminfo/functions/rpmaddtag.xml new file mode 100644 index 000000000..162f69c98 --- /dev/null +++ b/reference/rpminfo/functions/rpmaddtag.xml @@ -0,0 +1,71 @@ + + + + + + rpmaddtag + Añade un tag recuperado en una consulta + + + + &reftitle.description; + + boolrpmaddtag + inttag + + + Añade un tag recuperado en una consulta previa. + + + + + &reftitle.parameters; + + + tag + + + Una de las constantes RPMTAG_*, ver la página de las constantes rpminfo. + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.seealso; + + rpminfo + rpmdbinfo + rpmdbsearch + + + + + diff --git a/reference/rpminfo/functions/rpmdbinfo.xml b/reference/rpminfo/functions/rpmdbinfo.xml new file mode 100644 index 000000000..d2314ac07 --- /dev/null +++ b/reference/rpminfo/functions/rpmdbinfo.xml @@ -0,0 +1,111 @@ + + + + + + rpmdbinfo + Devuelve la información de un RPM instalado + + + + &reftitle.description; + + arraynullrpmdbinfo + stringnevr + boolfull&false; + + + Recupera la información sobre un paquete instalado, desde la base de datos RPM del sistema. + + + + + &reftitle.parameters; + + + nevr + + + El nombre con opcionalmente el epoch, la versión y la release. + + + + + full + + + Si es &true;, se recupera toda la información de cabecera del fichero, de lo contrario, solo un conjunto mínimo. + + + + + + + + &reftitle.returnvalues; + + Un array de array de información o NULL en caso de error. + + + + + &reftitle.examples; + + Un ejemplo de <function>rpmdbinfo</function> + + +]]> + + &example.outputs; + + Array + ( + [Name] => php-pecl-rpminfo + [Version] => 0.4.2 + [Release] => 1.fc31 + [Summary] => RPM information + [Installtime] => 1586244687 + [Arch] => x86_64 + ) +) +]]> + + + + + + &reftitle.seealso; + + rpmaddtag + + + + + diff --git a/reference/rpminfo/functions/rpmdbsearch.xml b/reference/rpminfo/functions/rpmdbsearch.xml new file mode 100644 index 000000000..1389366e8 --- /dev/null +++ b/reference/rpminfo/functions/rpmdbsearch.xml @@ -0,0 +1,131 @@ + + + + + + rpmdbsearch + Busca paquetes RPM + + + + &reftitle.description; + + arraynullrpmdbsearch + stringpattern + intrpmtagRPMTAG_NAME + intrpmmire-1 + boolfull&false; + + + Busca paquetes en la base de datos RPM del sistema. + + + + + &reftitle.parameters; + + + pattern + + + El valor a buscar. + + + + + rpmtag + + + El criterio de búsqueda, una de las constantes + RPMTAG_*. + + + + + rpmmire + + + El tipo de patrón, una de las constantes + RPMMIRE_*. + Cuando < 0 el criterio debe ser igual al valor, y el índice de la base de datos es utilizado si es posible. + + + + + full + + + Si &true; toda la información de encabezado para el fichero es recuperada, de lo contrario solo un conjunto mínimo. + + + + + + + + &reftitle.returnvalues; + + Un array de array de información o &null; en caso de error. + + + + + &reftitle.examples; + + Búsqueda del paquete que posee un fichero + + +]]> + + &example.outputs; + + Array + ( + [Name] => php-cli + [Version] => 7.4.4 + [Release] => 1.fc32 + [Summary] => Interfaz de línea de comandos para PHP + [Arch] => x86_64 + ) + +) +]]> + + + + + + &reftitle.seealso; + + rpmaddtag + + + + + diff --git a/reference/rpminfo/functions/rpmdefine.xml b/reference/rpminfo/functions/rpmdefine.xml new file mode 100644 index 000000000..731c45281 --- /dev/null +++ b/reference/rpminfo/functions/rpmdefine.xml @@ -0,0 +1,105 @@ + + + + + + rpmdefine + Define o cambia el valor de una macro RPM + + + + &reftitle.description; + + boolrpmdefine + stringtext + + + Define o cambia el valor de una macro RPM. + + + Puede ser utilizado para seleccionar la ruta de acceso de la base de datos y el motor a utilizar + en lugar del predeterminado del sistema. + + + + + + &reftitle.parameters; + + + text + + + El nombre de la macro, las opciones, el cuerpo. + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.examples; + + Un ejemplo de <function>rpmdefine</function> + + +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + rpmexpand + rpmdbinfo + + + + + + diff --git a/reference/rpminfo/functions/rpmexpand.xml b/reference/rpminfo/functions/rpmexpand.xml new file mode 100644 index 000000000..75e771c2e --- /dev/null +++ b/reference/rpminfo/functions/rpmexpand.xml @@ -0,0 +1,90 @@ + + + + + + rpmexpand + Obtiene el valor expandido de una macro RPM + + + + &reftitle.description; + + stringrpmexpand + stringtext + + + Obtiene el valor expandido de una macro RPM. + + + + + &reftitle.parameters; + + + text + + + El texto con las macros RPM a expandir. + + + + + + + + &reftitle.returnvalues; + + Un string con la(s) macro(s) expandida(s) concatenada(s). + + + + + &reftitle.examples; + + Un ejemplo de <function>rpmexpand</function> + + +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + rpmexpandnumeric + + + + + diff --git a/reference/rpminfo/functions/rpmexpandnumeric.xml b/reference/rpminfo/functions/rpmexpandnumeric.xml new file mode 100644 index 000000000..e2c103810 --- /dev/null +++ b/reference/rpminfo/functions/rpmexpandnumeric.xml @@ -0,0 +1,94 @@ + + + + + + rpmexpandnumeric + Obtiene el valor numérico de una macro RPM + + + + &reftitle.description; + + intrpmexpandnumeric + stringtext + + + Obtiene el valor numérico de una macro RPM. + + + + + &reftitle.parameters; + + + text + + + El texto con las macros RPM a expandir. + + + + + + + + &reftitle.returnvalues; + + La expansión de la macro como int. + Los valores booleanos (Y o y retorna 1, + N o n retorna 0) + también están permitidos. + Una macro no definida retorna 0. + + + + + &reftitle.examples; + + Un ejemplo <function>rpmexpandnumeric</function> + + +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + rpmexpand + + + + + diff --git a/reference/rpminfo/functions/rpmgetsymlink.xml b/reference/rpminfo/functions/rpmgetsymlink.xml new file mode 100644 index 000000000..9485af9c9 --- /dev/null +++ b/reference/rpminfo/functions/rpmgetsymlink.xml @@ -0,0 +1,73 @@ + + + + + + rpmgetsymlink + Devuelve el destino de un enlace simbólico + + + + &reftitle.description; + + stringnullrpmgetsymlink + stringpath + stringname + + + Devuelve el destino de un enlace simbólico. + + + + + + &reftitle.parameters; + + + path + + + La ruta de acceso del fichero RPM. + + + + + name + + + El nombre del fichero enlace simbólico. + + + + + + + + &reftitle.returnvalues; + + Un string con el destino del enlace simbólico, + &null; en caso de error, o una cadena vacía si no es un enlace simbólico. + + + + + diff --git a/reference/rpminfo/functions/rpminfo.xml b/reference/rpminfo/functions/rpminfo.xml new file mode 100644 index 000000000..eca85befe --- /dev/null +++ b/reference/rpminfo/functions/rpminfo.xml @@ -0,0 +1,120 @@ + + + + + + rpminfo + Devuelve información de un fichero RPM + + + + &reftitle.description; + + arraynullrpminfo + stringpath + boolfull&false; + stringerror + + + Devuelve información sobre un fichero local, un paquete RPM. + + + + + + &reftitle.parameters; + + + path + + + La ruta de acceso del fichero RPM. + + + + + full + + + Si &true;, se recupera toda la información de cabecera del fichero, + de lo contrario, solo un conjunto mínimo. + + + + + error + + + Si se proporciona, recibirá el mensaje de error posible, + y evitará una advertencia de ejecución. + + + + + + + + &reftitle.returnvalues; + + Un array de información, o &null; en caso de error. + + + + + &reftitle.examples; + + Un ejemplo de <function>rpminfo</function> + + +]]> + + &example.outputs; + + php-pecl-rpminfo + [Version] => 0.4.2 + [Release] => 1.el8 + [Summary] => RPM information + [Buildtime] => 1586244821 + [Arch] => x86_64 +) +]]> + + + + + + &reftitle.seealso; + + rpmaddtag + + + + + diff --git a/reference/rpminfo/functions/rpmvercmp.xml b/reference/rpminfo/functions/rpmvercmp.xml new file mode 100644 index 000000000..80062b732 --- /dev/null +++ b/reference/rpminfo/functions/rpmvercmp.xml @@ -0,0 +1,129 @@ + + + + + + rpmvercmp + Comparación de versiones RPM + + + + &reftitle.description; + + intboolrpmvercmp + stringevr1 + stringevr2 + stringnulloperator&null; + + + Compara dos versiones de paquetes RPM. + + + + + &reftitle.parameters; + + + evr1 + + + La primera cadena epoch:version-release. + + + + + evr2 + + + La segunda cadena epoch:version-release. + + + + + operator + + + Un operador opcional. + Los operadores posibles son: + + < + lt + <= + le + > + gt + >= + ge + == + = + eq + != + <> + ne + . + + + Este parámetro distingue mayúsculas y minúsculas, los valores deben estar en minúsculas. + + + + + + + + &reftitle.returnvalues; + + Devuelve -1 si evr1 es inferior a + evr2, 1 si evr1 es + superior a evr2, y 0 si son iguales. + + + Cuando se utiliza el argumento opcional operator, la función + devolverá &true; si la relación es la especificada por + el operador, en caso contrario &false;. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + PECL rpminfo 0.7.0 + + El operator opcional ha sido añadido. + + + + + + + + + diff --git a/reference/rpminfo/reference.xml b/reference/rpminfo/reference.xml new file mode 100644 index 000000000..08abddc33 --- /dev/null +++ b/reference/rpminfo/reference.xml @@ -0,0 +1,29 @@ + + + + + &Functions; de RpmInfo + + &reference.rpminfo.entities.functions; + + + diff --git a/reference/rpminfo/setup.xml b/reference/rpminfo/setup.xml new file mode 100644 index 000000000..ec052727a --- /dev/null +++ b/reference/rpminfo/setup.xml @@ -0,0 +1,42 @@ + + + + + &reftitle.setup; + +
+ &reftitle.required; + + Esta extensión requiere la versión 4.11.3 o superior de librpm. + +
+ +
+ Instalación mediante PECL + + &pecl.info; + &url.pecl.package;rpminfo. + +
+ + +