documentation/manual/pl/module_specs/Zend_Mime_Part.xml

   1 <sect1 id="zend.mime.part">
   2     <title>Zend_Mime_Part</title>
   3
   4     <sect2 id="zend.mime.part.introduction">
   5       <title>Wprowadzenie</title>
   6
   7       <para>Ta klasa reprezentuje pojedynczą część wiadomości MIME. Zawiera ona
   8       aktualną zawartość części wiadomości oraz informacje o jej kodowaniu, typie
   9       oraz o oryginalej nazwie pliku. Dostarcza ona metody do generowania łańcuchów
  10       znaków z przechowywanych danych. Obiekty <code>Zend_Mime_Part</code> mogą
  11       być dodane do
  12       <link linkend="zend.mime.message"><code>Zend_Mime_Message</code></link>
  13       aby zebrać kompletną wieloczęściową wiadomość.</para>
  14     </sect2>
  15
  16     <sect2 id="zend.mime.part.instantiation">
  17         <title>Tworzenie instancji</title>
  18
  19         <para>Obiekt <code>Zend_Mime_Part</code> jest tworzony z łańcuchem znaków
  20         zawierającym część wiadomości podanym jako parametr konstruktora.
  21         Domyślny typ to OCTET-STREAM, a kodowanie to 8Bit. Po utworzeniu obiektu
  22         <code>Zend_Mime_Part</code>, jego podstawowe atrybuty mogą być zmienione
  23         bezpośrednio:</para>
  24
  25          <programlisting role="php"><![CDATA[
  26 public $type = ZMime::TYPE_OCTETSTREAM;
  27 public $encoding = ZMime::ENCODING_8BIT;
  28 public $id;
  29 public $disposition;
  30 public $filename;
  31 public $description;
  32 public $charset;
  33 ]]>
  34         </programlisting>
  35     </sect2>
  36
  37   <sect2 id="zend.mime.part.methods">
  38     <title>Metody do renderowania części wiadomości do łańcucha znaków</title>
  39
  40     <para><code>getContent()</code> zwraca zawartość MimePart zakodowaną
  41     jako łańcuch znaków przy użyciu kodowania określonego w atrybucie $encoding.
  42     Poprawne wartości to ZMime::ENCODING_*. Konwersje zestawów znaków nie są
  43     przeprowadzane.</para>
  44
  45     <para>
  46         <code>getHeaders()</code> zwraca nagłówki Mime dla zawartości
  47         MimePart wygenerowane na podstawie informacji zawartych w publicznie dostępnych
  48         atrybutach. Przed wywołaniem tej metody, atrybuty obiektu muszą być poprawnie
  49         zdefiniowane.
  50         <itemizedlist>
  51             <listitem>
  52                 <para>
  53                     <code>$charset</code>
  54                     musi określać aktualny zestaw znaków zawartości, jeśli jest ona typu
  55                     tekstowego (Text lub HTML).
  56                 </para>
  57            </listitem>
  58
  59            <listitem>
  60                <para>
  61                    <code>$id</code>
  62                    może być ustawiony aby identyfikować obrazy wstawione bezpośrfednio
  63                    w kodzie wiadomości HTML.
  64                </para>
  65            </listitem>
  66            <listitem>
  67                <para>
  68                    <code>$filename</code>
  69                    zawiera nazwę pliku która będzie mu nadana gdy będzie on ściągany.
  70                </para>
  71            </listitem>
  72            <listitem>
  73                <para>
  74                    <code>$disposition</code>
  75                    określa czy plik powinien być traktowany jako załącznik, czy powinien być
  76                    użyty bezpośrednio w wiadomości HTML.
  77                </para>
  78            </listitem>
  79            <listitem>
  80                <para>
  81                    <code>$description</code>
  82                    jest używane jedynie dla celów informacyjnych.
  83                </para>
  84            </listitem>
  85       </itemizedlist>
  86     </para>
  87   </sect2>
  88 </sect1>