DOCTYPE is specified as the next of XML declaration. Please specify as follows.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE components PUBLIC "-//SEASAR2.1//DTD S2Container//EN"
"http://www.seasar.org/dtd/components21.dtd">
<components>
    <component name="hello" class="Hello"/>
    . . .
</components>

Components tag is a root tag of DICON file. Namespace can be specified with the namespace attribute of a components tag.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE components PUBLIC "-//SEASAR2.1//DTD S2Container//EN"
"http://www.seasar.org/dtd/components21.dtd">
<components namespace="dao">
    ...
</components>

By specifying namespace with a namespace attribute, when the definition of a component is divided, the collision of a component name is avoidable. In the following example, foo.dicon and bar.dicon are included in parent.dicon. The component of a same name called service is defined in each DICON file.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE components PUBLIC "-//SEASAR2.1//DTD S2Container//EN"
"http://www.seasar.org/dtd/components21.dtd">
<components>
    <include path="/path/to/foo.dicon"/>
    <include path="/path/to/bar.dicon"/>

    <component name="service" class="DefaultService"/>
</components>

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE components PUBLIC "-//SEASAR2.1//DTD S2Container//EN"
"http://www.seasar.org/dtd/components21.dtd">
<components namespace="foo">
    <component name="service" class="FooService"/>
</components>

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE components PUBLIC "-//SEASAR2.1//DTD S2Container//EN"
"http://www.seasar.org/dtd/components21.dtd">
<components namespace="bar">
    <component name="service" class="BarService"/>
</components>

The service component defined by parent.dicon can be referred to without specification of namespace. If the service component defined by foo.dicon and bar.dicon is referred, it is necessary to specify the name space. The name space is specified with Piriord ".". When the service component of foo.dicon is referred, it becomes the following.

<?php
require_once('S2Container/S2Container.php');

$container  = seasar:container\factory\S2ContainerFactory::create('/path/to/parent.dicon');
$service    = $container->getComponent('service');
$fooService = $container->getComponent('foo.service');
$barService = $container->getComponent('bar.service');
?>

include tag is used when taking in the definition of divided S2Container. The path of a DICON file is specified with a path attribute. (required) It is necessary to describe an include tag in front of a component tag. If DICON file specified with the path attribute does not exist, a path attribute value is passed to an eval function as PHP Expression. Therefore, the constant and class variable which are contained in a path are evaluated.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE components PUBLIC "-//SEASAR2.1//DTD S2Container//EN"
"http://www.seasar.org/dtd/components21.dtd">
<components>
    <include path="path/to/foo.dicon" />
    <include path="DICON_DIR . '/bar.dicon'" />
</components>

The order of search of a component looks for the component first registered into itself. The case where a component is not found, the component registered into child S2Container is searched with the included turn, and the component found first is returned.

The component tag defines a component.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE components PUBLIC "-//SEASAR2.1//DTD S2Container//EN"
"http://www.seasar.org/dtd/components21.dtd">
<components>
    <component name="action" class="IndexAction" instance="singleton" autoBinding="auto"/>
</components>

When an arg tag is used as a child tag of an component tag, it becomes an argument of a constructor. The arg tag is passed to a constructor in the described turn. It becomes an argument of a method when it is used as a child tag of an initMethod tag. The following item can be set to the body of a arg tag.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE components PUBLIC "-//SEASAR2.1//DTD S2Container//EN"
"http://www.seasar.org/dtd/components21.dtd">
<components>
    <component class="Hoge">
        <arg>"seasar"</arg>
        <arg><component class="Foo"/></arg>
        <initMethod name="addService">
            <arg>new Bar</arg>
        </initMethod>
    </component>
</components>

A property tag is used as a child tag of component tag. The following item can be set to the body of a property tag.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE components PUBLIC "-//SEASAR2.1//DTD S2Container//EN"
"http://www.seasar.org/dtd/components21.dtd">
<components>
    <component class="Hoge">
        <property name="project">"seasar"</property>
    </component>
</components>

A initMethod is used as a child tag of component tag. A method argument is specified with an arg tag. When not writing a name attribute, PHP can be described on a body. In PHP expression, the instance of the component with which the initMethod tag is defined is set as $component.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE components PUBLIC "-//SEASAR2.1//DTD S2Container//EN"
"http://www.seasar.org/dtd/components21.dtd">
<components>
    <component class="HashMap">
        <initMethod name="put">
            <arg>"aaa"</arg>
            <arg>111</arg>
        </initMethod>
        <initMethod>$component->put("aaa", 111);</initMethod>
        <initMethod>print "Hello";</initMethod>
    </component>
</components>

An aspect is applied to a component. The name of Interceptor component is specified with the body of aspect tag.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE components PUBLIC "-//SEASAR2.1//DTD S2Container//EN"
"http://www.seasar.org/dtd/components21.dtd">
<components>
    <component name="trace" class="seasar\aop\interceptor\TraceInterceptor"/>
    <component class="IndexAction">
        <aspect pointcut=".*Action">trace</aspect>
    </component>
</components>

The meta tag can specify as a child tag of components tag, component tag, arg tag, and property tag. The following item can be set to the body of a meta tag.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE components PUBLIC "-//SEASAR2.1//DTD S2Container//EN"
"http://www.seasar.org/dtd/components21.dtd">
<components>
    <meta name="project">"seasar"</meta>
    <component class="Hoge">
        <meta name="service">true</meta>
    </component>
</components>

The description tag can specify as a child tag of components tag, component tag, arg tag, and property tag. Explanation can be described freely.