Application Configurations

今天看到有人将http://www.pradosoft.com/demos/quickstart/?page=Configurations.AppConfig 翻译了出来。

转帖一下。

感谢网络上这些无私的人

 

  

  应用程序配置被用作详细地指定一个程序的全局行为。它包含了地址别名(path alias)、命名空间用法(namespace usage)、模块(module)和服务(service)的配置以及参数(parameter)的详细规格说明。

    应用程序的配置是存储在一个名为application.xml的XML文件中的，这个文件应该存放于应用程序的根目录中。其格式如下：

<application 属性名称="属性值" ...>

  <paths>

    <alias id="地址别名的ID" path="地址" />

    <using namespace="命名空间" />

  </paths>

  <modules>

    <module id="模块的ID" class="模块对应的类名" 属性名="属性值" ... />

  </modules>

  <services>

    <service id="服务的ID" class="服务对应的类名" 属性名="属性值" ... />

  </services>

  <parameters>

    <parameter id="参数的ID" class="参数对应的类名" 属性名="属性值"... />

  </parameters>

</application>

 

注解：

• 最外层的标签<application>对应了TApplication的一个实例。属性名="属性值"赋值对指定了TApplication的属性的初始值。
• <paths>标签包含了地址别名的定义以及应用程序的PHP包含地址。每一个地址别名都是由指定的一个<alias>标签中的 path属性来取得的。绝对地址或者相对地址（相对于配置文件的地址）。<using>标签指定了一个特殊的地址（用术语说就是命名空间），当程序运行时，这个地址将被附加到PHP的包含路径中。Prado默认定义了两个特殊的别名:System和Application。在Prado以往的版本中，别名相对于Prado框架的根目录，在新版中，别名相对于配置文件所在目录。
• <modules>标签包含了一个模块配置的列表。每个模块的配置被指定于<module>标签中。每个模块唯一地区别于ID属性和类型class。属性名="属性值"赋值对指定了模块的初始值。
• <servics>标签类似于<modules>标签，它主要指定了应用程序所提供的服务。
• <parameters>标签包含了一个应用程序级的参数列表，可以使程序在任意的地方访问到它。你可以指定一些组件类型的参数就像指定模块或一些字符串类型的参数一样，它们有共同的格式，如下所示：

<parameter id="参数的ID" value="参数值" />

注意，如果value属性未被指定，那么所有的XML参数节点（类型为TXmlElement）将被当作value来返回。更多的，System.Util.TParameterModule模块提供了一个从额外的XML文件中载入文件的方法。更多的细节请参阅他们的API文档。

    完全的应用程序配置规格说明书可以在DTD和XSD文件中找到。

    在默认配置中，一个基于Prado的程序将会在运行时加载一些少量的核心模块，比如THttpRequest、THttpResponse等等。它将同时提供TPageService作为默认的服务。

    在该指南中，配置和使用这些模块与服务的例子分布在一些章节中。

    注意，如果你程序的模块和服务应用了默认配置，那么你无需再提供一个。不过，如果你认为这些默认配置不丰富或者你想通过配置属性值来改变它们行为的话，你将会需要一份应用程序的配置。