<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.mcrypt.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ja',
  ),
  'this' => 
  array (
    0 => 'function.mcrypt-generic.php',
    1 => 'mcrypt_generic',
    2 => 'データを暗号化する',
  ),
  'up' => 
  array (
    0 => 'ref.mcrypt.php',
    1 => 'Mcrypt 関数',
  ),
  'prev' => 
  array (
    0 => 'function.mcrypt-encrypt.php',
    1 => 'mcrypt_encrypt',
  ),
  'next' => 
  array (
    0 => 'function.mcrypt-generic-deinit.php',
    1 => 'mcrypt_generic_deinit',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ja',
    'path' => 'reference/mcrypt/functions/mcrypt-generic.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.mcrypt-generic" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">mcrypt_generic</h1>
  <p class="verinfo">(PHP 4 &gt;= 4.0.2, PHP 5, PHP 7 &lt; 7.2.0, PECL mcrypt &gt;= 1.0.0)</p><p class="refpurpose"><span class="refname">mcrypt_generic</span> &mdash; <span class="dc-title">データを暗号化する</span></p>

 </div>
 <div id="function.mcrypt-generic-refsynopsisdiv">
  <div class="warning"><strong class="warning">警告</strong><p class="simpara">この関数は PHP 7.1.0 で
<em>非推奨</em>となり、PHP 7.2.0 で<em>削除</em>
されました。この関数に頼らないことを強く推奨します。</p></div>
 </div>
 <div class="refsect1 description" id="refsect1-function.mcrypt-generic-description">
  <h3 class="title">説明</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>mcrypt_generic</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> <code class="parameter">$td</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$data</code></span>): <span class="type"><a href="language.types.string.php" class="type string">string</a></span></div>

  <p class="simpara">
   この関数は、データを暗号化します。データ長を n * blocksize とする
   ために、データは &quot;<code class="literal">\0</code>&quot; で埋められます。
   この関数は、暗号化されたデータを返します。
   データのパディングが行われるため、返される文字列の長さは
   入力よりも長いことがあることに注意してください。
  </p>
  <p class="simpara">
   暗号化したデータをデータベースに格納する場合は、mcrypt_generic
   が返す文字列全てを格納することを忘れないでください。さもないと、
   文字列を適切に復号できなくなります。もとの文字列が 10 文字で
   ブロックサイズが 8 (ブロックサイズを調べるには
   <span class="function"><a href="function.mcrypt-enc-get-block-size.php" class="function">mcrypt_enc_get_block_size()</a></span> を使用します)
   だった場合、データベースのフィールドには少なくとも 16 文字が
   必要です。<span class="function"><a href="function.mdecrypt-generic.php" class="function">mdecrypt_generic()</a></span> が返す文字列も
   16 文字となることに注意しましょう。埋められた文字を取り除くには...
   rtrim($str, &quot;\0&quot;) を使用します。
  </p>
  <p class="simpara">
   もし MySQL データベースにデータを格納する場合は、
   varchar フィールドに値を挿入する際に末尾のスペースが取り除かれることを
   覚えておきましょう。暗号化されたデータの最後にスペース(ASCII 32)が
   含まれていた場合、この処理によってデータが破壊されてしまいます。
   かわりに tinyblob/tinytext (あるいはより大きな) フィールドを
   使用してください。
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.mcrypt-generic-parameters">
  <h3 class="title">パラメータ</h3>
  <dl>
   
    <dt><code class="parameter">td</code></dt>
    <dd>
     <span class="simpara">
      暗号化記述子。
     </span>
     <span class="simpara">
      この関数をコールする前には、常にキーと IV を用いて
      <span class="function"><a href="function.mcrypt-generic-init.php" class="function">mcrypt_generic_init()</a></span> で暗号化ハンドルを
      初期化しておくべきです。暗号化が終了したら、
      <span class="function"><a href="function.mcrypt-generic-deinit.php" class="function">mcrypt_generic_deinit()</a></span> をコールして
      暗号化バッファを開放すべきです。使用例は
      <span class="function"><a href="function.mcrypt-module-open.php" class="function">mcrypt_module_open()</a></span> を参照ください。
     </span>
    </dd>
   
   
    <dt><code class="parameter">data</code></dt>
    <dd>
     <span class="simpara">
      暗号化するデータ。
     </span>
    </dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.mcrypt-generic-returnvalues">
  <h3 class="title">戻り値</h3>
  <p class="simpara">
   暗号化したデータを返します。
  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.mcrypt-generic-seealso">
  <h3 class="title">参考</h3>
  <ul class="simplelist">
   <li><span class="function"><a href="function.mdecrypt-generic.php" class="function" rel="rdfs-seeAlso">mdecrypt_generic()</a> - データを復号する</span></li>
   <li><span class="function"><a href="function.mcrypt-generic-init.php" class="function" rel="rdfs-seeAlso">mcrypt_generic_init()</a> - 暗号化に必要な全てのバッファを初期化する</span></li>
   <li><span class="function"><a href="function.mcrypt-generic-deinit.php" class="function" rel="rdfs-seeAlso">mcrypt_generic_deinit()</a> - 暗号化モジュールを終了する</span></li>
  </ul>
 </div>


</div><?php manual_footer($setup); ?>