Procházet zdrojové kódy

[DOCUMENTATION] Add URL to Zend Server introduction and translate install section

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@24035 44c647ce-9c0f-0410-b52a-842ac1e357ba
yoshida@zend.co.jp před 14 roky
rodič
revize
fb260b8cc1

+ 3 - 1
documentation/manual/ja/module_specs/Zend_Cache-Backends.xml

@@ -247,6 +247,7 @@
           </table>
     </sect2>
 
+    <!-- TODO : to be translated -->
     <sect2 id="zend.cache.backends.libmemcached">
         <title>Zend_Cache_Backend_Libmemcached</title>
 
@@ -544,7 +545,7 @@ $cache = Zend_Cache::factory('Core', 'Two Levels');
         <title>Zend_Cache_Backend_ZendServer_Disk および Zend_Cache_Backend_ZendServer_ShMem</title>
         <para>
             これらのバックエンドは、キャッシュレコードの保存に
-            <ulink url="http://www.zend.com/en/products/server/downloads-all?zfs=zf_download">Zend Server</ulink>
+            <ulink url="http://www.zend.co.jp/product/zendserver.html">Zend Server</ulink>
             のキャッシュ機能を使用します。
         </para>
         <para>
@@ -570,6 +571,7 @@ $cache = Zend_Cache::factory('Core', 'Zend_Cache_Backend_ZendServer_Disk',
         </para>
     </sect2>
 
+    <!-- TODO : to be translated -->
     <sect2 id="zend.cache.backends.static">
         <title>Zend_Cache_Backend_Static</title>
         <para>

+ 24 - 1
documentation/manual/ja/module_specs/Zend_Captcha-Adapters.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21815 -->
+<!-- EN-Revision: 24024 -->
 <sect1 id="zend.captcha.adapters">
     <title>CAPTCHA アダプタ</title>
 
@@ -263,6 +263,29 @@
                 <methodname>getService()</methodname> で、
                 ReCaptcha サービスオブジェクトを取得したり取得したりします。
             </para></listitem>
+
+            <!-- TODO : to be translated -->
+            <listitem>
+                <para>
+                    <methodname>isValid($value, $context = null)</methodname> validates the user's
+                    input against the ReCaptcha service.  $value is an array with the following
+                    keys:
+                    <itemizedlist>
+                        <listitem>
+                            <para>
+                                recaptcha_challenge_field - Value of the ReCaptcha widget's 
+                                challenge field (hidden)
+                            </para>
+                        </listitem>
+                        <listitem>
+                            <para>
+                                recaptcha_response_field - Value of the ReCaptcha widget's
+                                user input field
+                            </para>
+                        </listitem>
+                    </itemizedlist>
+                </para>
+            </listitem>
         </itemizedlist>
     </sect2>
 </sect1>

+ 536 - 0
documentation/manual/ja/tutorials/quickstart-create-project.xml

@@ -0,0 +1,536 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<!-- EN-Revision: 21997 -->
+<sect1 id="learning.quickstart.create-project">
+    <title>プロジェクトを作成</title>
+
+    <para>
+        プロジェクトを作成するには、まず、Zend Frameworkをダウンロードして、解凍しなければいけません。
+    </para>
+
+    <sect2 id="learning.quickstart.create-project.install-zf">
+        <title>Zend Framework をインストール</title>
+
+        <para>
+            全部揃った <acronym>PHP</acronym> スタックと一緒に Zend Framework
+            を手に入れる最も簡単な方法は、<ulink
+             url="http://www.zend.co.jp/product/zendserver.html">Zend Server</ulink>
+            をインストールすることです。Zend Server には、
+            多くの Linux ディストリビューションと互換性のある一般的なインストール・パッケージだけでなく、
+            Mac OSX、Windows、Fedora Core および Ubuntu 用のネイティブのインストーラーがあります。
+        </para>
+
+        <para>
+            Zend Server をインストールし終わると、Mac OSX および Linux の場合は
+            <filename>/usr/local/zend/share/ZendFramework</filename> 配下に、
+            Windows の場合は 
+            <filename>C:\Program Files\Zend\ZendServer\share\ZendFramework</filename>
+            配下にフレームワークのファイルが見つかるでしょう。
+            <constant>include_path</constant>は、Zend Frameworkを含むように構成済みです。
+        </para>
+
+        <para>
+            あるいは、<ulink
+             url="http://framework.zend.com/download/latest">Zend Framework の最新版</ulink>
+            をダウンロードして内容を解凍することができます。
+            <!-- TODO  -->make a note of where you have done so.
+        </para>
+
+        <para>
+            <filename>php.ini</filename> の <constant>include_path</constant> 設定に
+            アーカイブの<filename>library/</filename>サブディレクトリへのパスを任意に追加できます。
+        </para>
+
+        <para>
+            これで終わりです。これで Zend Framework がインストールされ、使えるようになりました。
+        </para>
+    </sect2>
+
+    <sect2 id="learning.quickstart.create-project.create-project">
+        <title>プロジェクトを作成</title>
+
+        <note>
+            <title>zf コマンドラインツール</title>
+
+            <!-- TODO : to be translated -->
+            <para>
+                In your Zend Framework installation is a <filename>bin/</filename> subdirectory,
+                containing the scripts <filename>zf.sh</filename> and <filename>zf.bat</filename>
+                for Unix-based and Windows-based users, respectively. Make a note of the absolute
+                path to this script.
+            </para>
+
+            <para>
+                Wherever you see references to the command <command>zf</command>, please substitute
+                the absolute path to the script. On Unix-like systems, you may want to use your
+                shell's alias functionality: <command>alias
+                    zf.sh=path/to/ZendFramework/bin/zf.sh</command>.
+            </para>
+
+            <para>
+                If you have problems setting up the <command>zf</command> command-line tool, please
+                refer to <link linkend="zend.tool.framework.clitool">the
+                    manual</link>.
+            </para>
+        </note>
+
+        <para>
+            Open a terminal (in Windows, <command>Start -> Run</command>, and then use
+            <command>cmd</command>). Navigate to a directory where you would like to start a
+            project. Then, use the path to the appropriate script, and execute one of the following:
+        </para>
+
+        <programlisting language="shell"><![CDATA[
+% zf create project quickstart
+]]></programlisting>
+
+        <para>
+            Running this command will create your basic site structure, including your initial
+            controllers and views. The tree looks like the following:
+        </para>
+
+        <programlisting language="text"><![CDATA[
+quickstart
+|-- application
+|   |-- Bootstrap.php
+|   |-- configs
+|   |   `-- application.ini
+|   |-- controllers
+|   |   |-- ErrorController.php
+|   |   `-- IndexController.php
+|   |-- models
+|   `-- views
+|       |-- helpers
+|       `-- scripts
+|           |-- error
+|           |   `-- error.phtml
+|           `-- index
+|               `-- index.phtml
+|-- library
+|-- public
+|   |-- .htaccess
+|   `-- index.php
+`-- tests
+    |-- application
+    |   `-- bootstrap.php
+    |-- library
+    |   `-- bootstrap.php
+    `-- phpunit.xml
+]]></programlisting>
+
+        <para>
+            At this point, if you haven't added Zend Framework to your
+            <constant>include_path</constant>, we recommend either copying or symlinking it into
+            your <filename>library/</filename> directory. In either case, you'll want to either
+            recursively copy or symlink the <filename>library/Zend/</filename> directory of your
+            Zend Framework installation into the <filename>library/</filename> directory of your
+            project. On unix-like systems, that would look like one of the following:
+        </para>
+
+        <programlisting language="shell"><![CDATA[
+# Symlink:
+% cd library; ln -s path/to/ZendFramework/library/Zend .
+
+# Copy:
+% cd library; cp -r path/to/ZendFramework/library/Zend .
+]]></programlisting>
+
+        <para>
+            On Windows systems, it may be easiest to do this from the Explorer.
+        </para>
+
+        <para>
+            Now that the project is created, the main artifacts to begin understanding are the
+            bootstrap, configuration, action controllers, and views.
+        </para>
+    </sect2>
+
+    <sect2 id="learning.quickstart.create-project.bootstrap">
+        <title>The Bootstrap</title>
+
+        <para>
+            Your <classname>Bootstrap</classname> class defines what resources and components to
+            initialize. By default, Zend Framework's <link linkend="zend.controller.front">Front
+                Controller</link> is initialized, and it uses the
+            <filename>application/controllers/</filename> as the default directory in which to look
+            for action controllers (more on that later). The class looks like the following:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+// application/Bootstrap.php
+
+class Bootstrap extends Zend_Application_Bootstrap_Bootstrap
+{
+}
+]]></programlisting>
+
+        <para>
+            As you can see, not much is necessary to begin with.
+        </para>
+    </sect2>
+
+    <sect2 id="learning.quickstart.create-project.configuration">
+        <title>Configuration</title>
+
+        <para>
+            While Zend Framework is itself configurationless, you often need to configure your
+            application. The default configuration is placed in
+            <filename>application/configs/application.ini</filename>, and contains some basic
+            directives for setting your <acronym>PHP</acronym> environment (for instance, turning
+            error reporting on and off), indicating the path to your bootstrap class (as well as its
+            class name), and the path to your action controllers. It looks as follows:
+        </para>
+
+        <programlisting language="ini"><![CDATA[
+; application/configs/application.ini
+
+[production]
+phpSettings.display_startup_errors = 0
+phpSettings.display_errors = 0
+includePaths.library = APPLICATION_PATH "/../library"
+bootstrap.path = APPLICATION_PATH "/Bootstrap.php"
+bootstrap.class = "Bootstrap"
+appnamespace = "Application"
+resources.frontController.controllerDirectory = APPLICATION_PATH "/controllers"
+resources.frontController.params.displayExceptions = 0
+
+[staging : production]
+
+[testing : production]
+phpSettings.display_startup_errors = 1
+phpSettings.display_errors = 1
+
+[development : production]
+phpSettings.display_startup_errors = 1
+phpSettings.display_errors = 1
+]]></programlisting>
+
+        <para>
+            Several things about this file should be noted. First, when using
+            <acronym>INI</acronym>-style configuration, you can reference constants directly and
+            expand them; <constant>APPLICATION_PATH</constant> is actually a constant. Additionally
+            note that there are several sections defined: production, staging, testing, and
+            development. The latter three inherit settings from the "production" environment. This
+            is a useful way to organize configuration to ensure that appropriate settings are
+            available in each stage of application development.
+        </para>
+    </sect2>
+
+    <sect2 id="learning.quickstart.create-project.action-controllers">
+        <title>Action Controllers</title>
+
+        <para>
+            Your application's <emphasis>action controllers</emphasis> contain your application
+            workflow, and do the work of mapping your requests to the appropriate models and views.
+        </para>
+
+        <para>
+            An action controller should have one or more methods ending in "Action"; these methods
+            may then be requested via the web. By default, Zend Framework URLs follow the schema
+            <constant>/controller/action</constant>, where "controller" maps to the action
+            controller name (minus the "Controller" suffix) and "action" maps to an action method
+            (minus the "Action" suffix).
+        </para>
+
+        <para>
+            Typically, you always need an <classname>IndexController</classname>, which is a
+            fallback controller and which also serves the home page of the site, and an
+            <classname>ErrorController</classname>, which is used to indicate things such as
+            <acronym>HTTP</acronym> 404 errors (controller or action not found) and
+            <acronym>HTTP</acronym> 500 errors (application errors).
+        </para>
+
+        <para>
+            The default <classname>IndexController</classname> is as follows:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+// application/controllers/IndexController.php
+
+class IndexController extends Zend_Controller_Action
+{
+
+    public function init()
+    {
+        /* Initialize action controller here */
+    }
+
+    public function indexAction()
+    {
+        // action body
+    }
+}
+]]></programlisting>
+
+        <para>
+            And the default <classname>ErrorController</classname> is as follows:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+// application/controllers/ErrorController.php
+
+class ErrorController extends Zend_Controller_Action
+{
+
+    public function errorAction()
+    {
+        $errors = $this->_getParam('error_handler');
+
+        switch ($errors->type) {
+            case Zend_Controller_Plugin_ErrorHandler::EXCEPTION_NO_ROUTE:
+            case Zend_Controller_Plugin_ErrorHandler::EXCEPTION_NO_CONTROLLER:
+            case Zend_Controller_Plugin_ErrorHandler::EXCEPTION_NO_ACTION:
+
+                // 404 error -- controller or action not found
+                $this->getResponse()->setHttpResponseCode(404);
+                $this->view->message = 'Page not found';
+                break;
+            default:
+                // application error
+                $this->getResponse()->setHttpResponseCode(500);
+                $this->view->message = 'Application error';
+                break;
+        }
+
+        $this->view->exception = $errors->exception;
+        $this->view->request   = $errors->request;
+    }
+}
+]]></programlisting>
+
+        <para>
+            You'll note that (1) the <classname>IndexController</classname> contains no real code,
+            and (2) the <classname>ErrorController</classname> makes reference to a "view" property.
+            That leads nicely into our next subject.
+        </para>
+    </sect2>
+
+    <sect2 id="learning.quickstart.create-project.views">
+        <title>Views</title>
+
+        <para>
+            Views in Zend Framework are written in plain old <acronym>PHP</acronym>. View scripts
+            are placed in <filename>application/views/scripts/</filename>, where they are further
+            categorized using the controller names. In our case, we have an
+            <classname>IndexController</classname> and an <classname>ErrorController</classname>,
+            and thus we have corresponding <filename>index/</filename> and
+            <filename>error/</filename> subdirectories within our view scripts directory. Within
+            these subdirectories, you will then find and create view scripts that correspond to each
+            controller action exposed; in the default case, we thus have the view scripts
+            <filename>index/index.phtml</filename> and <filename>error/error.phtml</filename>.
+        </para>
+
+        <para>
+            View scripts may contain any markup you want, and use the <emphasis>&lt;?php</emphasis>
+            opening tag and <emphasis>?&gt;</emphasis> closing tag to insert <acronym>PHP</acronym>
+            directives.
+        </para>
+
+        <para>
+            The following is what we install by default for the
+            <filename>index/index.phtml</filename> view script:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+<!-- application/views/scripts/index/index.phtml -->
+<style>
+
+    a:link,
+    a:visited
+    {
+        color: #0398CA;
+    }
+
+    span#zf-name
+    {
+        color: #91BE3F;
+    }
+
+    div#welcome
+    {
+        color: #FFFFFF;
+        background-image: url(http://framework.zend.com/images/bkg_header.jpg);
+        width:  600px;
+        height: 400px;
+        border: 2px solid #444444;
+        overflow: hidden;
+        text-align: center;
+    }
+
+    div#more-information
+    {
+        background-image: url(http://framework.zend.com/images/bkg_body-bottom.gif);
+        height: 100%;
+    }
+
+</style>
+<div id="welcome">
+    <h1>Welcome to the <span id="zf-name">Zend Framework!</span><h1 />
+    <h3>This is your project's main page<h3 />
+    <div id="more-information">
+        <p>
+            <img src="http://framework.zend.com/images/PoweredBy_ZF_4LightBG.png" />
+        </p>
+
+        <p>
+            Helpful Links: <br />
+            <a href="http://framework.zend.com/">Zend Framework Website</a> |
+            <a href="http://framework.zend.com/manual/en/">Zend Framework
+                Manual</a>
+        </p>
+    </div>
+</div>
+]]></programlisting>
+
+        <para>
+            The <filename>error/error.phtml</filename> view script is slightly more interesting as
+            it uses some <acronym>PHP</acronym> conditionals:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+<!-- application/views/scripts/error/error.phtml -->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN";
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd>
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+  <title>Zend Framework Default Application</title>
+</head>
+<body>
+  <h1>An error occurred</h1>
+  <h2><?php echo $this->message ?></h2>
+
+  <?php if ('development' == $this->env): ?>
+
+  <h3>Exception information:</h3>
+  <p>
+      <b>Message:</b> <?php echo $this->exception->getMessage() ?>
+  </p>
+
+  <h3>Stack trace:</h3>
+  <pre><?php echo $this->exception->getTraceAsString() ?>
+  </pre>
+
+  <h3>Request Parameters:</h3>
+  <pre><?php echo var_export($this->request->getParams(), 1) ?>
+  </pre>
+  <?php endif ?>
+
+</body>
+</html>
+]]></programlisting>
+    </sect2>
+
+    <sect2 id="learning.quickstart.create-project.vhost">
+        <title>Create a virtual host</title>
+
+        <para>
+            For purposes of this quick start, we will assume you are using the <ulink
+                url="http://httpd.apache.org/">Apache web server</ulink>. Zend Framework works
+            perfectly well with other web servers -- including Microsoft Internet Information
+            Server, lighttpd, nginx, and more -- but most developers should be famililar with Apache
+            at the minimum, and it provides an easy introduction to Zend Framework's directory
+            structure and rewrite capabilities.
+        </para>
+
+        <para>
+            To create your vhost, you need to know the location of your
+            <filename>httpd.conf</filename> file, and potentially where other configuration files
+            are located. Some common locations:
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <filename>/etc/httpd/httpd.conf</filename> (Fedora や RHEL など)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <filename>/etc/apache2/httpd.conf</filename> (Debian や Ubuntu など)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <filename>/usr/local/zend/etc/httpd.conf</filename> (Linux 版 Zend Server)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <filename>C:\Program Files\Zend\Apache2\conf</filename> (Windows 版 Zend Server)
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <!-- TODO : to be translated -->
+        <para>
+            Within your <filename>httpd.conf</filename> (or <filename>httpd-vhosts.conf</filename>
+            on some systems), you will need to do two things. First, ensure that the
+            <varname>NameVirtualHost</varname> is defined; typically, you will set it to a value of
+            "*:80". Second, define a virtual host:
+        </para>
+
+        <programlisting language="apache"><![CDATA[
+<VirtualHost *:80>
+    ServerName quickstart.local
+    DocumentRoot /path/to/quickstart/public
+
+    SetEnv APPLICATION_ENV "development"
+
+    <Directory /path/to/quickstart/public>
+        DirectoryIndex index.php
+        AllowOverride All
+        Order allow,deny
+        Allow from all
+    </Directory>
+</VirtualHost>
+]]></programlisting>
+
+        <para>
+            There are several things to note. First, note that the <varname>DocumentRoot</varname>
+            setting specifies the <filename>public</filename> subdirectory of our project; this
+            means that only files under that directory can ever be served directly by the server.
+            Second, note the <varname>AllowOverride</varname>, <varname>Order</varname>, and
+            <varname>Allow</varname> directives; these are to allow us to use
+            <filename>htacess</filename> files within our project. During development, this is a
+            good practice, as it prevents the need to constantly restart the web server as you make
+            changes to your site directives; however, in production, you should likely push the
+            content of your <filename>htaccess</filename> file into your server configuration and
+            disable this. Third, note the <varname>SetEnv</varname> directive. What we are doing
+            here is setting an environment variable for your virtual host; this variable will be
+            picked up in the <filename>index.php</filename> and used to set the
+            <constant>APPLICATION_ENV</constant> constant for our Zend Framework application. In
+            production, you can omit this directive (in which case it will default to the value
+            "production") or set it explicitly to "production".
+        </para>
+
+        <para>
+            Finally, you will need to add an entry in your <filename>hosts</filename> file
+            corresponding to the value you place in your <varname>ServerName</varname> directive. On
+            *nix-like systems, this is usually <filename>/etc/hosts</filename>; on Windows, you'll
+            typically find it in <filename>C:\WINDOWS\system32\drivers\etc</filename>. Regardless of
+            the system, the entry will look like the following:
+        </para>
+
+        <programlisting language="text"><![CDATA[
+127.0.0.1 quickstart.local
+]]></programlisting>
+
+        <para>
+            Start your webserver (or restart it), and you should be ready to go.
+        </para>
+    </sect2>
+
+    <sect2 id="learning.quickstart.create-project.checkpoint">
+        <title>Checkpoint</title>
+
+        <para>
+            At this point, you should be able to fire up your initial Zend Framework application.
+            Point your browser to the server name you configured in the previous section; you should
+            be able to see a welcome page at this point.
+        </para>
+    </sect2>
+</sect1>