|
|
@@ -6,150 +6,172 @@
|
|
|
|
|
|
<sect2 id="zend.tool.framework.console-client">
|
|
|
|
|
|
- <title>Customizing Zend_Tool Console Client</title>
|
|
|
+ <title>Anpassen des Zend_Tool Konsolen Clients</title>
|
|
|
|
|
|
<para>
|
|
|
- As of Zend Framework 1.9, <classname>Zend_Tool_Framework</classname> allows developers to store information,
|
|
|
- provider specific configuration values, and custom files in a special location on the developers machine.
|
|
|
- These configuration values and files can be used by providers to extend functionality, customize
|
|
|
- functionality, or any other reasons a provider sees fit.
|
|
|
+ Mit Zend Framework 1.9 erlaubt es <classname>Zend_Tool_Framework</classname> Entwicklern
|
|
|
+ Informationen zu Speichern, Provider spezifische Konfigurationswerte, und eigene Dateien
|
|
|
+ an einem speziellen Ort auf der Entwicklermaschine. Diese Konfigurationswerte und
|
|
|
+ Dateien können von Providern verwendet werden um Funktionalität zu erweitern, sie
|
|
|
+ anzupassen, oder aus einem anderen Grund welcher dem Provider passt.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- The primary purpose, and the purpose most immediately used by existing providers is to allow developers to
|
|
|
- customize the way the "out of the box" providers do work.
|
|
|
+ Der primäre Zwecke, und der warscheinlich wichtigste der von existierenden Providern
|
|
|
+ verwendet wird, besteht darin es Entwicklern zu erlauben den Weg wie die
|
|
|
+ "out of the box" Provider funktionieren zu verändern.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- One of the more commonly requested features is to be able to provide custom project profiles to
|
|
|
- <classname>Zend_Tool_Project</classname>'s Project Provider. This would allow developers to store a
|
|
|
- custom profile in a special place that can be used repeatedly by the <classname>Zend_Tool</classname>
|
|
|
- system in order to build custom profiles. Another commonly requested feature is to be able to configure
|
|
|
- the behavior of providers with a configuration setting. In order to achieve this, not only do we have
|
|
|
- to have a <classname>Zend_Tool</classname> configuration file, but we also have to have a place
|
|
|
- to find this configuration file.
|
|
|
+ Eines der üblichsten angefragten Features ist es, in der Lage zu sein
|
|
|
+ <classname>Zend_Tool_Project</classname>'s Projekt Provider eigene Projekt Profile
|
|
|
+ anzubieten. Das würde es Entwicklern erlauben ein eigenes Profil an einem speziellen
|
|
|
+ Platz zu speichern, der wiederholt vom <classname>Zend_Tool</classname> System verwendet
|
|
|
+ werden kann um eigene Profile zu erstellen. Ein anderes üblicherweise angefragtes
|
|
|
+ Feature ist es in der Lage zu sein das Verhalten von Providern mit
|
|
|
+ Konfigurationseinstellungen zu verändern. Um das zu tun benötigen wir nicht nur eine
|
|
|
+ <classname>Zend_Tool</classname> Konfigurationsdatei, sondern auch einen Ort an dem wir
|
|
|
+ diese Konfigurationsdatei finden können.
|
|
|
</para>
|
|
|
|
|
|
<sect3 id="zend.tool.framework.console-client.home-directory">
|
|
|
|
|
|
- <title>The Home Directory</title>
|
|
|
+ <title>Das Home Verzeichnis</title>
|
|
|
|
|
|
<para>
|
|
|
- Before the Console Client can start searching for a <classname>Zend_Tool</classname> configuration
|
|
|
- file or a local storage directory, it must first be able to identify where the "home directory" is
|
|
|
- located.
|
|
|
+ Bevor der Konsolen Client beginnen kann nach einer <classname>Zend_Tool</classname>
|
|
|
+ Konfigurationsdatei zu suchen, oder einem lokalen Speicherverzeichnis, muß er
|
|
|
+ zuerst in der Lage sein zu erkennen wo das "Home Verzeichnis" liegt.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- On *nix-based machines, <acronym>PHP</acronym> will be populated with an environment variable named
|
|
|
- <constant>HOME</constant> with a path to the current users home directory. Typically, this path will
|
|
|
- be very similar to <filename>/home/myusername</filename>.
|
|
|
+ Auf *nix basierten Maschinen, wird <acronym>PHP</acronym> mit einer
|
|
|
+ Umgebungsvariable die <constant>HOME</constant> heißt, und dem Pfad zum Home
|
|
|
+ Verzeichnis des aktuellen Benutzers, bekannt gegeben. Typischerweise ist dieser
|
|
|
+ Pfad ähnlich wie <filename>/home/myusername</filename>.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- On Windows-based machines, <acronym>PHP</acronym> will typically be populated with an environment
|
|
|
- variable named <constant>HOMEPATH</constant> with the current users home directory. This directory
|
|
|
- is usually found in either <filename>C:\Documents and Settings\Username\</filename>, or in Vista at
|
|
|
- <filename>C:\Users\Username</filename>.
|
|
|
+ Auf Windows basierten Maschinen, wird <acronym>PHP</acronym> typischerweise mit
|
|
|
+ einer Umgebungsvariable die <constant>HOMEPATH</constant> heißt, und dem Pfad zum
|
|
|
+ Home Verzeichnis des aktuellen Benutzers, bekannt gegeben. Das Verzeichnis kann
|
|
|
+ normalerweise, entweder unter
|
|
|
+ <filename>C:\Documents and Settings\Username\</filename>, oder bei Vista unter
|
|
|
+ <filename>C:\Users\Username</filename> gefunden werden.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- If either a home directory cannot be found, or you wish to change the location of where
|
|
|
- <classname>Zend_Tool_Framework</classname> Console Client finds the home directory, you can provide
|
|
|
- an environment variable named <constant>ZF_HOME</constant> to specify where to find the home
|
|
|
- directory.
|
|
|
+ Wenn entweder das Home Verzeichnis nicht gefunden werden kann, oder man den Ort an
|
|
|
+ dem der <classname>Zend_Tool_Framework</classname> Konsolen Client das Home
|
|
|
+ Verzeichnis findet, ändern will kann man eine Umgebungsvariable die
|
|
|
+ <constant>ZF_HOME</constant> heißt angeben um zu spezifizieren wo das Home
|
|
|
+ Verzeichnis gefunden werden kann.
|
|
|
</para>
|
|
|
</sect3>
|
|
|
|
|
|
<sect3 id="zend.tool.framework.console-client.local-storage">
|
|
|
|
|
|
- <title>Local Storage</title>
|
|
|
+ <title>Lokaler Speicher</title>
|
|
|
|
|
|
<para>
|
|
|
- Once a home directory can be located, <classname>Zend_Tool_Framework</classname>'s Console Client
|
|
|
- can either autodiscover the local storage directory, or it can be told where to expect the local
|
|
|
- storage directory.
|
|
|
+ Sobald das Home Verzeichnis gefunden werden kann, kann
|
|
|
+ <classname>Zend_Tool_Framework</classname>'s Konsolen Client entweder das lokale
|
|
|
+ Speicher Verzeichnis automatisch erkennen, oder es kann Ihm mitgeteilt werden wo
|
|
|
+ das lokale Speicherverzeichnis erwartet wird.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Assuming the home directory has been found (here noted as <varname>$HOME</varname>), the Console
|
|
|
- Client will then look for the local storage directory in <filename>$HOME/.zf/</filename>. If found,
|
|
|
- it will set the local storage directory to this location.
|
|
|
+ Angenommen das Home Verzeichnis wurde gefunden (hier als <varname>$HOME</varname>
|
|
|
+ bezeichnet), dann wird der Konsolen client nach dem lokalen Speicherverzeichnis
|
|
|
+ unter <filename>$HOME/.zf/</filename> nachsehen. Wenn es gefunden wird, dann wird
|
|
|
+ das lokale Speicherverzeichnis auf diesen Ort gesetzt.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- If the directory cannot be found, or the developer wishes to override this location, that can be done
|
|
|
- by setting an environment variable. Regardless if <varname>$HOME</varname> has been previously set or
|
|
|
- not, the developer may supply the environment variable <constant>ZF_STORAGE_DIRECTORY</constant>.
|
|
|
+ Wenn das Verzeichnis nicht gefunden werden kann, oder der Entwickler den Ort
|
|
|
+ überschreiben will, kann man das durch Setzen einer Umgebungsvariable durchführen.
|
|
|
+ Unabhängig davon ob <varname>$HOME</varname> vorher gesetzt wurde, kann der
|
|
|
+ Entwickler die Umgebungsvariable <constant>ZF_STORAGE_DIRECTORY</constant> anbieten.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Once the path to a local storage directory is found, the directory <emphasis>must</emphasis> exist
|
|
|
- for it to be passed into the <classname>Zend_Tool_Framework</classname> runtime, as it will not be
|
|
|
- created for you.
|
|
|
+ Sobald der Pfad zu einem lokalen Speicherverzeichnis gefunden wurde,
|
|
|
+ <emphasis>muss</emphasis> das Verzeichnis existieren damit es an die
|
|
|
+ <classname>Zend_Tool_Framework</classname> Runtime übergeben werden kann, da dieses
|
|
|
+ für Sie nicht erstellt wird.
|
|
|
</para>
|
|
|
</sect3>
|
|
|
|
|
|
<sect3 id="zend.tool.framework.console-client.configuration-file">
|
|
|
|
|
|
- <title>User Configuration</title>
|
|
|
+ <title>Benutzer Konfiguration</title>
|
|
|
|
|
|
<para>
|
|
|
- Like local storage, once a home directory can be located, <classname>Zend_Tool_Framework</classname>'s
|
|
|
- Console Client can then either attempt to autodiscover the path to a configuration file, or it can be
|
|
|
- told specifically where to find the configuration file.
|
|
|
+ Wie beim lokalen Speicher kann <classname>Zend_Tool_Framework</classname>'s
|
|
|
+ Konsolen Client, sobald ein Home Verzeichnis gefunden wurde, entweder versuchen den
|
|
|
+ Pfad zu einer Konfigurationsdatei autoamtisch zu erkennen, oder es kann Ihm ganz
|
|
|
+ spezifisch gesagt werden wo die Konfigurationsdatei gefunden werden kann.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Assuming the home directory has been found (here noted as <varname>$HOME</varname>), the Console Client
|
|
|
- will then attempt to look for the existence of a configuration file located at
|
|
|
- <filename>$HOME/.zf.ini</filename>. This file, if found, will be used as the configuration file for
|
|
|
- <classname>Zend_Tool_Framework</classname>.
|
|
|
+ Angenommen das Home Verzeichnis wurde gefunden (hier als <varname>$HOME</varname>
|
|
|
+ bezeichnet), dann wird der Konsolen Client versuchen nach der Existenz einer
|
|
|
+ Konfigurationsdatei zu sehen die in <filename>$HOME/.zf.ini</filename> liegt.
|
|
|
+ Diese Datei wird, wenn Sie gefunden wurde, als Konfigurationsdatei für
|
|
|
+ <classname>Zend_Tool_Framework</classname> verwendet.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- If that location does not exist, but a local storage directory does, then the Console Client will then
|
|
|
- attempt to locate the configuration file within the local storage directory. Assuming the local storage
|
|
|
- directory exists in <varname>$LOCAL_STORAGE</varname>, then if a file exists as
|
|
|
- <filename>$LOCAL_STORAGE/zf.ini</filename>, it will be found by the Console Client and utilized as the
|
|
|
- <classname>Zend_Tool_Framework</classname> configuration file.
|
|
|
+ Wenn der Ort nicht existiert, aber das lokale Speicherverzeichnis, dann wird der
|
|
|
+ Konsolen Client versuchen die Konfigurationsdatei im lokalen Speicherverzeichnis zu
|
|
|
+ finden. Angenommen das lokale Speicherverzeichnis existiert in
|
|
|
+ <varname>$LOCAL_STORAGE</varname>, und eine Datei existiert als
|
|
|
+ <filename>$LOCAL_STORAGE/zf.ini</filename>, dann wird diese vom Konsolen Client
|
|
|
+ gefunden und als <classname>Zend_Tool_Framework</classname> Konfigurationsdatei
|
|
|
+ verwendet.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- If the file cannot be autodiscovered or the developer wishes to specify the location of location of the
|
|
|
- configuration file, the developer can do so by setting an evironment variable. If the environment
|
|
|
- variable <constant>ZF_CONFIG_FILE</constant> is set, then its value will be used as the location of the
|
|
|
- configuration file to use with the Console Client.
|
|
|
+ Wenn die Datei nicht automatisch erkannt werden kann, oder der Entwickler den Ort
|
|
|
+ der Konfigurationsdatei spezifizieren will, kann er das durch Setzen einer
|
|
|
+ Umgebungsvariable tun. Wenn die Umgebungsvariable
|
|
|
+ <constant>ZF_CONFIG_FILE</constant> gesetzt ist, dann wird dieser Wert als Ort der
|
|
|
+ Konfigurationsdatei verwendet die mit dem Konsolen Client zu verwenden ist.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- If the file does not exist in either the autodiscovered or the provided location, it will not be used as
|
|
|
- <classname>Zend_Tool_Framework</classname> does not attempt to create the file automatically.
|
|
|
+ Wenn die Datei weder an der automatisch erkannten, noch an der angegebenen Position
|
|
|
+ existiert, dann wird Sie nicht verwendet da
|
|
|
+ <classname>Zend_Tool_Framework</classname> nicht versucht diese Datei automatisch
|
|
|
+ zu erstellen.
|
|
|
</para>
|
|
|
|
|
|
</sect3>
|
|
|
|
|
|
<sect3 id="zend.tool.framework.console-client.configuration-content">
|
|
|
|
|
|
- <title>User Configuration File Content</title>
|
|
|
+ <title>Inhalt der Benutzer Konfigurationsdatei</title>
|
|
|
|
|
|
<para>
|
|
|
- The configuration file should be structured as a <classname>Zend_Config</classname> configuration
|
|
|
- file, in ini format, and without any sections being defined. First level keys should be used by the
|
|
|
- provider searching for a specific value. For example, if the "Project" provider is expecting a
|
|
|
- "profiles" directory, then it should typically be understood that it will search for the following ini
|
|
|
- key value pair:
|
|
|
+ Die Konfigurationdatei sollte als <classname>Zend_Config</classname>
|
|
|
+ Konfigurationdatei, im Ini format, strukturiert sein und ohne zusätzliche definierte
|
|
|
+ Sektionen. Schlüssel des ersten Levels sollten vom Provider verwendet werden um nach
|
|
|
+ einem speziellen Wert zu suchen. Wenn der "Project" Provider zum Beispiel ein
|
|
|
+ "profiles" Verzeichnis erwartet, dann sollte typischerweise darunter verstanden
|
|
|
+ werden das er im folgenden Schlüssel Wertpaar gesucht wird:
|
|
|
</para>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|
|
|
-project.profile = some/path/to/some-directory
|
|
|
+project.profile = irgendein/pfad/zu/irgendeinem-verzeichnis
|
|
|
]]></programlisting>
|
|
|
|
|
|
<para>
|
|
|
- The only reserved ini prefix is the value "php". The "php" prefix to values will be reserved to store
|
|
|
- names and values of runtime settable php values, such as <property>include_path</property> or
|
|
|
- <property>error_reporting</property>. To override the <property>include_path</property> and
|
|
|
- <property>error_reporting</property> with an ini value, a developer would set:
|
|
|
+ Der einzige reservierte Ini Präfix ist der Wert "php". Der "php" Präfix für Werte
|
|
|
+ ist reserviert um Namen und Werte, von wärend der Laufzeit setzbaren Php Werte, zu
|
|
|
+ setzen, wie <property>include_path</property> oder
|
|
|
+ <property>error_reporting</property>. Um <property>include_path</property> oder
|
|
|
+ <property>error_reporting</property> mit einem Ini Wert zu überschreiben, würde ein
|
|
|
+ Entwickler folgendes setzen:
|
|
|
</para>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|