【PHP8.x】saveメソッドの使い方

Copy
1<?php
2
3// 配列をXML形式でファイルに保存する関数
4function saveArrayToXmlFile(array $data, string $filename): int|false
5{
6    // DOMDocumentのインスタンスを生成
7    $dom = new DOMDocument('1.0', 'UTF-8');
8    $dom->preserveWhiteSpace = false;
9    $dom->formatOutput = true;
10
11    // ルート要素を作成
12    $root = $dom->createElement('data');
13    $dom->appendChild($root);
14
15    // 配列の各要素をXML要素として追加
16    foreach ($data as $key => $value) {
17        $element = $dom->createElement($key, htmlspecialchars($value));
18        $root->appendChild($element);
19    }
20
21    // ファイルにXMLを保存
22    return $dom->save($filename);
23}
24
25// 保存する配列の例
26$data = [
27    'name' => 'John Doe',
28    'age' => 30,
29    'city' => 'New York'
30];
31
32// ファイル名
33$filename = 'data.xml';
34
35// 関数を実行してファイルを保存
36$result = saveArrayToXmlFile($data, $filename);
37
38// 結果の確認
39if ($result !== false) {
40    echo "XMLファイル '$filename' が正常に保存されました。\n";
41} else {
42    echo "XMLファイルの保存に失敗しました。\n";
43}

このサンプルコードは、PHPのDOMDocumentクラスのsaveメソッドを使用して、配列をXML形式でファイルに保存する方法を示します。

まず、saveArrayToXmlFile関数は、保存したい配列 $data とファイル名 $filename を引数として受け取ります。この関数内では、DOMDocumentオブジェクトを生成し、XMLの基本的な設定（空白の保持、整形出力）を行います。

次に、配列の各要素をXMLの要素として追加します。配列のキーがXML要素のタグ名となり、値が要素の値となります。htmlspecialchars関数を使用することで、特殊文字をエスケープし、XMLファイルが正しく解析されるようにします。

そして、$dom->save($filename) が save メソッドの呼び出しです。このメソッドは、XMLドキュメントを $filename で指定されたファイルに保存します。第二引数 $options はここでは省略されており、デフォルト値の 0 が使用されています。

save メソッドは、保存に成功した場合は書き込まれたバイト数を返し、失敗した場合は false を返します。

サンプルコードでは、保存結果を確認し、成功したか失敗したかをメッセージで表示しています。これにより、ファイルが正常に保存されたかどうかを簡単に確認できます。

save メソッドを使用することで、PHPの配列データをXML形式でファイルに保存し、データの永続化や異なるシステム間でのデータ交換を容易に実現できます。

Copy
1<?php
2
3/**
4 * URLから画像を取得して保存する関数
5 *
6 * @param string $imageUrl 画像のURL
7 * @param string $filename 保存するファイル名
8 * @return bool 保存に成功した場合はtrue、失敗した場合はfalse
9 */
10function saveImageFromUrl(string $imageUrl, string $filename): bool
11{
12    try {
13        // URLから画像データを取得
14        $imageData = file_get_contents($imageUrl);
15
16        // 画像データが取得できたか確認
17        if ($imageData === false) {
18            error_log("Failed to get image data from URL: $imageUrl");
19            return false;
20        }
21
22        // ファイルに画像データを保存
23        $result = file_put_contents($filename, $imageData);
24
25        // 保存結果を確認
26        if ($result === false) {
27            error_log("Failed to save image to file: $filename");
28            return false;
29        }
30
31        return true;
32
33    } catch (Exception $e) {
34        error_log("An error occurred: " . $e->getMessage());
35        return false;
36    }
37}
38
39// 例: 画像をURLから取得して保存する
40$imageUrl = 'https://www.easygifanimator.net/images/samples/video-to-gif-sample.gif'; // 例としてGIFを指定
41$filename = 'image.gif'; // 保存するファイル名
42
43if (saveImageFromUrl($imageUrl, $filename)) {
44    echo "Image saved successfully to $filename" . PHP_EOL;
45} else {
46    echo "Failed to save image." . PHP_EOL;
47}
48
49?>

このサンプルコードは、PHPのfile_get_contents関数とfile_put_contents関数を使用して、指定されたURLから画像データをダウンロードし、ローカルファイルに保存する関数saveImageFromUrlを定義しています。

saveImageFromUrl関数は、画像のURL（$imageUrl）と保存先のファイル名（$filename）を引数として受け取ります。まず、file_get_contents関数を使ってURLから画像データを取得します。取得に失敗した場合は、エラーログに記録し、falseを返します。

画像データが正常に取得できた場合、file_put_contents関数を使用して、取得した画像データを指定されたファイル名で保存します。保存に失敗した場合も、エラーログに記録し、falseを返します。

画像の保存に成功した場合は、trueを返します。関数全体はtry-catchブロックで囲まれており、例外が発生した場合もエラーログに記録し、falseを返します。

サンプルコードの後半部分では、saveImageFromUrl関数を実際に呼び出し、画像の保存を試みています。保存が成功した場合は「Image saved successfully to ファイル名」というメッセージを、失敗した場合は「Failed to save image.」というメッセージをそれぞれ表示します。このサンプルは、URLから画像を取得して保存する基本的な方法を示しており、システムエンジニアを目指す初心者にとって、ファイル操作とエラーハンドリングの理解を深める上で役立ちます。