怎樣通過hash_copy 和file_put_contents 將哈希值複製並保存到文件中？

M66 2025-07-10

1. hash_copy函數介紹

PHP 的hash_copy函數並不是一個內建函數，實際上這個函數是可以通過自定義的方式來模擬複製哈希值的功能。我們通過創建一個哈希值副本來實現類似hash_copy的效果。

哈希值通常是通過某些哈希算法生成的，比如md5 、 sha1或者更現代的sha256 。對於哈希值的操作，常用的函數是hash() 。 hash()函數返回一個指定算法計算後的哈希值。

1.1 創建哈希值的副本

假設我們首先生成一個文件或數據流的哈希值，並將該值存儲在一個變量中。然後，我們可以通過賦值語句將該哈希值“複製”到另一個變量中，模擬哈希值的“複製”操作：

 <span><span><span class="hljs-variable">$data</span></span><span> = </span><span><span class="hljs-string">'This is a sample text.'</span></span><span>;
</span><span><span class="hljs-variable">$original_hash</span></span><span> = </span><span><span class="hljs-title function_ invoke__">hash</span></span><span>(</span><span><span class="hljs-string">'sha256'</span></span><span>, </span><span><span class="hljs-variable">$data</span></span><span>);
</span></span>

這樣， $copied_hash變量就保存了與$original_hash相同的哈希值。

2. 使用file_put_contents保存哈希值到文件

file_put_contents是PHP 中非常常用的一個文件操作函數，它可以用來將數據寫入到文件中。我們可以利用這個函數將哈希值保存到一個文本文件中。

2.1 寫入哈希值

在上面已經獲取到哈希值後，接下來我們將其寫入到一個指定的文件中：

 <span><span><span class="hljs-variable">$file</span></span><span> = </span><span><span class="hljs-string">'hash_output.txt'</span></span><span>;
</span><span><span class="hljs-title function_ invoke__">file_put_contents</span></span><span>(</span><span><span class="hljs-variable">$file</span></span><span>, </span><span><span class="hljs-variable">$copied_hash</span></span><span>);
</span></span>

這段代碼將$copied_hash中的哈希值寫入名為hash_output.txt的文件中。如果文件不存在， file_put_contents會自動創建它。

2.2 追加模式寫入

如果你希望每次運行時將新生成的哈希值追加到文件末尾，而不是覆蓋原有內容，可以使用FILE_APPEND參數：

 <span><span><span class="hljs-title function_ invoke__">file_put_contents</span></span><span>(</span><span><span class="hljs-variable">$file</span></span><span>, </span><span><span class="hljs-variable">$copied_hash</span></span><span> . PHP_EOL, FILE_APPEND);
</span></span>

這裡，我們還加上了PHP_EOL ，它表示平台相關的換行符，確保每個哈希值單獨占一行。

3. 完整示例：哈希值複製與保存

結合上述內容，下面是一個完整的示例，展示如何通過hash_copy和file_put_contents將哈希值複製並保存到文件中：

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 1. 生成數據的哈希值</span></span><span>
</span><span><span class="hljs-variable">$data</span></span><span> = </span><span><span class="hljs-string">'This is a sample text.'</span></span><span>;
</span><span><span class="hljs-variable">$original_hash</span></span><span> = </span><span><span class="hljs-title function_ invoke__">hash</span></span><span>(</span><span><span class="hljs-string">'sha256'</span></span><span>, </span><span><span class="hljs-variable">$data</span></span><span>);


</span><span><span class="hljs-comment">// 3. 保存到文件</span></span><span>
</span><span><span class="hljs-variable">$file</span></span><span> = </span><span><span class="hljs-string">'hash_output.txt'</span></span><span>;
</span><span><span class="hljs-title function_ invoke__">file_put_contents</span></span><span>(</span><span><span class="hljs-variable">$file</span></span><span>, </span><span><span class="hljs-variable">$copied_hash</span></span><span> . PHP_EOL, FILE_APPEND);

</span><span><span class="hljs-comment">// 輸出提示</span></span><span>
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"哈希值已經被保存到文件: <span class="hljs-subst">$file</span></span></span><span>\n";
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

這個腳本會將文本'This is a sample text.'的SHA-256 哈希值計算出來，並將其追加到hash_output.txt文件中。

4. 處理文件操作的錯誤

在處理文件操作時，我們要注意可能出現的錯誤，例如文件權限問題或路徑錯誤。為了提高代碼的健壯性，可以加上錯誤處理代碼：

 <span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-literal">false</span></span><span> === </span><span><span class="hljs-title function_ invoke__">file_put_contents</span></span><span>(</span><span><span class="hljs-variable">$file</span></span><span>, </span><span><span class="hljs-variable">$copied_hash</span></span><span> . PHP_EOL, FILE_APPEND)) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"文件寫入失敗，請檢查文件權限。\n"</span></span><span>;
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"哈希值已經成功保存到文件。\n"</span></span><span>;
}
</span></span>

5. 總結

通過hash()函數計算哈希值，模擬hash_copy複製哈希值，並使用file_put_contents將哈希值寫入文件，是PHP 中處理哈希值和文件操作的常見方法。無論是將哈希值保存為文件，還是將其追加到現有文件中，PHP 提供的這些函數都能夠幫助我們方便地實現。