/
registerlocalnamespace.xml
112 lines (101 loc) · 3.76 KB
/
registerlocalnamespace.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 7418592d82d6cde8d052effd3607e5761d6c4e67 Maintainer: seros Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<refentry xml:id="yaf-loader.registerlocalnamespace" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Yaf_Loader::registerLocalNamespace</refname>
<refpurpose>Registra un prefijo de clase local</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>void</type><methodname>Yaf_Loader::registerLocalNamespace</methodname>
<methodparam><type>mixed</type><parameter>prefix</parameter></methodparam>
</methodsynopsis>
<para>
Registra un nombre de prefijo de clase local. <classname>Yaf_Loader</classname> busca
clases en dos directorios de bibliotecas, uno se configura mediante <link
linkend="configuration.yaf.library">application.library.directory</link> (en
application.ini) al que se le llama directorio de bibliotecas local; el otro se
configura mediante <link linkend="ini.yaf.library">yaf.library</link> (en
php.ini) al que se llamma le directorio de bibliotecas global, ya que puede ser compartido
mediante muchas apliacionies en el mismo servidor.
</para>
<para>
Al desencadenar una autocarga, <classname>Yaf_Loader</classname> determinará
en que directorio de bibliotecas debería buscar examinando el nombre de
prefijo del nombre de clase faltante.
Si el nombre de prefijo está registrado como un paquete de nombres local, entonces se le buscará
en el directorio de bibliotecas local, si no, se buscará en el directorio de bibliotecas global.
<note>
<para>
Si yaf.library no está configurado, se asume que el directorio de bibliotecas global es
el directorio de bibliotecas local. En este caso, todas las auto cargas
buscarán en el directorio de bibliotecas local.
Aunque si se quiere que una aplicación Yaf sea fuerte, se han de registrar siempre
las propias clases como clases locales.
</para>
</note>
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>prefix</parameter></term>
<listitem>
<para>
Un string o un a array con el prefijo del nombre de la clase.
Todas las clases con este prefijo se cargarán en la ruta de la biblioteca local.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un booleano.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo de <function>Yaf_Loader::registerLocalNamespace</function></title>
<programlisting role="php">
<![CDATA[
<?php
$loader = Yaf_Loader::getInstance('/local/library/', '/global/library');
$loader->registerLocalNamespace("Baidu");
$loader->registerLocalNamespace(array("Sina", "Weibo"));
$loader->autoload("Baidu_Name"); // buscar en '/local/library/'
$loader->autoload("Sina"); // buscar en '/local/library/'
$loader->autoload("Global_Name");// buscar en '/global/library/'
$loader->autoload("Foo_Bar"); // buscar en '/global/library/'
?>
]]>
</programlisting>
</example>
</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
-->