php/archived-doc-de
1
0
Fork 0
mirror of https://github.com/php/doc-de.git synced 2026-03-24 07:12:15 +01:00
Code Issues Packages Projects Releases Wiki Activity
Files
master
archived-doc-de/language/wrappers/ssh2.xml
Sergey Panteleev c73ea82b2d Sync with EN (#178)
2024-07-26 18:42:48 +00:00

304 lines
9.3 KiB
XML
Raw Permalink Blame History

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8bc832a464e33122e8129f5a623bd845b69fa7e0 Maintainer: samesch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="wrappers.ssh2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_wrapper">
<refnamediv>
<refname>ssh2://</refname>
<refpurpose>Secure Shell 2</refpurpose>
</refnamediv>
<refsect1 role="description"><!-- {{{ -->
&reftitle.description;
<para>
<filename>ssh2.shell://</filename>
<filename>ssh2.exec://</filename>
<filename>ssh2.tunnel://</filename>
<filename>ssh2.sftp://</filename>
<filename>ssh2.scp://</filename>
(PECL)
</para>
<note>
<title>Dieser Wrapper ist standardmäßig nicht aktiviert</title>
<simpara>
Um den Wrapper <filename>ssh2.*://</filename> verwenden zu können, muss
die <link xlink:href="&url.pecl.package;ssh2">SSH2</link>-Erweiterung von
&link.pecl; installiert werden
</simpara>
</note>
<simpara>
Neben den herkömmlichen URI-Anmeldedaten akzeptieren die ssh2-Wrapper auch
eine im Host-Teil der URL übergebene Verbindungsressource, mit der offene
Verbindungen wiederverwendet werden können.
</simpara>
</refsect1><!-- }}} -->
<refsect1 role="usage"> <!-- {{{ -->
&reftitle.usage;
<itemizedlist>
<listitem><simpara><filename>ssh2.shell://user:pass@example.com:22/xterm</filename></simpara></listitem>
<listitem><simpara><filename>ssh2.exec://user:pass@example.com:22/usr/local/bin/somecmd</filename></simpara></listitem>
<listitem><simpara><filename>ssh2.tunnel://user:pass@example.com:22/192.168.0.1:14</filename></simpara></listitem>
<listitem><simpara><filename>ssh2.sftp://user:pass@example.com:22/path/to/filename</filename></simpara></listitem>
</itemizedlist>
</refsect1> <!-- }}} -->
<refsect1 role="options"><!-- {{{ -->
&reftitle.options;
<para>
<table>
<title>Zusammenfassung des Wrappers</title>
<tgroup cols="6">
<thead>
<row>
<entry>Eigenschaft</entry>
<entry>ssh2.shell</entry>
<entry>ssh2.exec</entry>
<entry>ssh2.tunnel</entry>
<entry>ssh2.sftp</entry>
<entry>ssh2.scp</entry>
</row>
</thead>
<tbody>
<row>
<entry>Eingeschränkt durch <link linkend="ini.allow-url-fopen">allow_url_fopen</link></entry>
<entry>Ja</entry>
<entry>Ja</entry>
<entry>Ja</entry>
<entry>Ja</entry>
<entry>Ja</entry>
</row>
<row>
<entry>Erlaubt Lesen</entry>
<entry>Ja</entry>
<entry>Ja</entry>
<entry>Ja</entry>
<entry>Ja</entry>
<entry>Ja</entry>
</row>
<row>
<entry>Erlaubt Schreiben</entry>
<entry>Ja</entry>
<entry>Ja</entry>
<entry>Ja</entry>
<entry>Ja</entry>
<entry>Nein</entry>
</row>
<row>
<entry>Erlaubt Anfügen</entry>
<entry>Nein</entry>
<entry>Nein</entry>
<entry>Nein</entry>
<entry>Ja (falls vom Server unterstützt)</entry>
<entry>Nein</entry>
</row>
<row>
<entry>Erlaubt gleichzeitiges Lesen und Schreiben</entry>
<entry>Ja</entry>
<entry>Ja</entry>
<entry>Ja</entry>
<entry>Ja</entry>
<entry>Nein</entry>
</row>
<row>
<entry>Unterstützt <function>stat</function></entry>
<entry>Nein</entry>
<entry>Nein</entry>
<entry>Nein</entry>
<entry>Ja</entry>
<entry>Nein</entry>
</row>
<row>
<entry>Unterstützt <function>unlink</function></entry>
<entry>Nein</entry>
<entry>Nein</entry>
<entry>Nein</entry>
<entry>Ja</entry>
<entry>Nein</entry>
</row>
<row>
<entry>Unterstützt <function>rename</function></entry>
<entry>Nein</entry>
<entry>Nein</entry>
<entry>Nein</entry>
<entry>Ja</entry>
<entry>Nein</entry>
</row>
<row>
<entry>Unterstützt <function>mkdir</function></entry>
<entry>Nein</entry>
<entry>Nein</entry>
<entry>Nein</entry>
<entry>Ja</entry>
<entry>Nein</entry>
</row>
<row>
<entry>Unterstützt <function>rmdir</function></entry>
<entry>Nein</entry>
<entry>Nein</entry>
<entry>Nein</entry>
<entry>Ja</entry>
<entry>Nein</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<!-- FIXME: This should be context.ssh2!!! -->
<para>
<table>
<title>Kontextoptionen</title>
<tgroup cols="3">
<thead>
<row>
<entry>Name</entry>
<entry>Verwendung</entry>
<entry>Voreinstellung</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>session</literal></entry>
<entry>Vorab verbundene ssh2-Ressource, die wiederverwendet werden soll</entry>
<entry/>
</row>
<row>
<entry><literal>sftp</literal></entry>
<entry>Vorab zugewiesene sftp-Ressource, die wiederverwendet werden soll</entry>
<entry/>
</row>
<row>
<entry><literal>methods</literal></entry>
<entry>Schlüsselaustausch, Host-Schlüssel, Verschlüsselung, Komprimierung und MAC-Methoden, die verwendet werden sollen</entry>
<entry/>
</row>
<row>
<entry><literal>callbacks</literal></entry>
<entry></entry>
<entry></entry>
</row>
<row>
<entry><literal>username</literal></entry>
<entry>Der Benutzername für die Verbindung</entry>
<entry></entry>
</row>
<row>
<entry><literal>password</literal></entry>
<entry>Das Passwort für die Authentifizierung</entry>
<entry></entry>
</row>
<row>
<entry><literal>pubkey_file</literal></entry>
<entry>Der Name der Datei, die den öffentlichen Schlüssel für die Authentifizierung enthält</entry>
<entry></entry>
</row>
<row>
<entry><literal>privkey_file</literal></entry>
<entry>Der Name der Datei, die den privaten Schlüssel für die Authentifizierung enthält</entry>
<entry></entry>
</row>
<row>
<entry><literal>env</literal></entry>
<entry>Ein assoziatives Array der zu setzenden Umgebungsvariablen</entry>
<entry></entry>
</row>
<row>
<entry><literal>term</literal></entry>
<entry>Der Typ der Terminalemulation, der bei der Zuweisung eines pty angefordert wird</entry>
<entry></entry>
</row>
<row>
<entry><literal>term_width</literal></entry>
<entry>Die Breite des Terminals, die bei der Zuweisung eines pty angefordert wird</entry>
<entry></entry>
</row>
<row>
<entry><literal>term_height</literal></entry>
<entry>Die Höhe des Terminals, die bei der Zuweisung eines pty angefordert wird</entry>
<entry></entry>
</row>
<row>
<entry><literal>term_units</literal></entry>
<entry>Die Einheiten, die für term_width und term_height verwendet werden sollen</entry>
<entry><constant>SSH2_TERM_UNIT_CHARS</constant></entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</refsect1> <!-- }}} -->
<refsect1 role="examples"><!-- {{{ -->
&reftitle.examples;
<example>
<title>Öffnen eines Streams aus einer aktiven Verbindung</title>
<programlisting role="php">
<![CDATA[
<?php
$session = ssh2_connect('example.com', 22);
ssh2_auth_pubkey_file($session, 'username', '/home/username/.ssh/id_rsa.pub',
'/home/username/.ssh/id_rsa', 'secret');
$stream = fopen("ssh2.tunnel://$session/remote.example.com:1234", 'r');
?>
]]>
</programlisting>
</example>
<example>
<title>Diese <varname>$session</varname>-Variable muss immer verfügbar sein!</title>
<simpara>
Um die <filename>ssh2.*://$session</filename>-Wrapper verwenden zu können,
muss die Ressourcenvariable <varname>$session</varname> erhalten bleiben.
Der folgende Code hat nicht die gewünschte Wirkung:
</simpara>
<programlisting role="php">
<![CDATA[
<?php
$session = ssh2_connect('example.com', 22);
ssh2_auth_pubkey_file($session, 'username', '/home/username/.ssh/id_rsa.pub',
'/home/username/.ssh/id_rsa', 'secret');
$connection_string = "ssh2.sftp://$session/";
unset($session);
$stream = fopen($connection_string . "path/to/file", 'r');
?>
]]>
</programlisting>
<simpara>
unset() schließt die Session, weil <varname>$connection_string</varname>
keinen Verweis auf die Variable <varname>$session</varname> enthält,
sondern nur eine von ihr abgeleitete Zeichenkette. Dies ist auch der Fall,
wenn <function>unset</function> implizit aufgerufen wird, weil der
Gültigkeitsbereich verlassen wird (&zb; bei einer Funktion).
</simpara>
</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
-->
Reference in New Issue View Git Blame Copy Permalink