【PHP8.x】DELETE定数の使い方

Copy
1<?php
2
3/**
4 * 指定されたファイルをシステムから削除します。
5 *
6 * この関数は、ファイルが存在しない場合でもエラーとはせず、
7 * 成功として扱います。
8 *
9 * @param string $filePath 削除するファイルのパス。
10 * @return bool ファイルの削除に成功した場合、またはファイルが存在しなかった場合はtrue。
11 *              それ以外の場合はfalse（例: 権限不足）。
12 */
13function deleteFile(string $filePath): bool
14{
15    // 削除しようとしているファイルが存在するかどうかを確認します。
16    if (!file_exists($filePath)) {
17        echo "情報: ファイル '{$filePath}' は存在しません。削除は不要です。" . PHP_EOL;
18        return true; // ファイルが存在しない場合は成功とみなします。
19    }
20
21    // unlink() 関数を使用してファイルを削除します。
22    // unlink() は成功した場合は true を、失敗した場合は false を返します。
23    if (unlink($filePath)) {
24        echo "成功: ファイル '{$filePath}' を削除しました。" . PHP_EOL;
25        return true;
26    } else {
27        echo "エラー: ファイル '{$filePath}' の削除に失敗しました。権限を確認してください。" . PHP_EOL;
28        return false;
29    }
30}
31
32// ----------------------------------------------------
33// サンプルコードの実行例
34// ----------------------------------------------------
35
36// 削除対象となるサンプルファイルの名前を定義します。
37$sampleFileName = 'my_document_to_delete.txt';
38
39// サンプルファイルを作成します。（このスクリプトを単体で動作させるため）
40// 実際の使用では、既存のファイルを指定します。
41if (file_put_contents($sampleFileName, "これは削除されるべきテストファイルです。\n") === false) {
42    echo "エラー: サンプルファイル '{$sampleFileName}' の作成に失敗しました。スクリプトを終了します。" . PHP_EOL;
43    exit(1);
44}
45echo "情報: テストファイル '{$sampleFileName}' を作成しました。" . PHP_EOL;
46
47// 作成したファイルを削除します。
48deleteFile($sampleFileName);
49
50// 削除に成功したか、ファイルが存在しないかを確認します。
51if (!file_exists($sampleFileName)) {
52    echo "確認: ファイル '{$sampleFileName}' はシステム上に存在しません。" . PHP_EOL;
53} else {
54    echo "確認: ファイル '{$sampleFileName}' はまだ存在します。" . PHP_EOL;
55}
56
57// 存在しないファイルを削除しようとする別の例
58deleteFile('non_existent_document.txt');

PHPでファイルシステムからファイルを削除する方法について説明します。このサンプルコードは、指定されたパスのファイルを安全に削除するための deleteFile 関数を提供しています。

deleteFile 関数は、引数として削除するファイルのパス（string $filePath）を受け取ります。まず、file_exists() 関数を使って削除対象のファイルがシステム上に存在するかを確認します。もしファイルが存在しない場合、関数は削除の必要がないため成功とみなし、true を返します。

ファイルが存在する場合は、PHPの組み込み関数である unlink() を用いて実際のファイル削除処理を実行します。unlink() はファイルの削除に成功すると true を、何らかの原因で失敗すると false を返します。deleteFile 関数もこの unlink() の結果をそのまま真偽値（bool）として返します。ファイル削除が失敗する一般的な理由としては、対象ファイルへのアクセス権限不足などが考えられます。この関数は、削除の成否に応じて適切なメッセージを出力し、システムエンジニアがファイルの削除処理を安全かつ効果的に行うための基盤を提供します。

Copy
1<?php
2
3/**
4 * PHP配列から要素を削除する様々な方法を示すサンプルコード。
5 *
6 * システムエンジニアを目指す初心者が、配列から特定の要素や範囲を削除する方法を
7 * 理解できるように、代表的な関数（unset, array_filter, array_splice）を用いています。
8 */
9function deleteElementsFromArrayExample(): void
10{
11    // 元の配列を準備
12    $items = ['apple', 'banana', 'cherry', 'date', 'elderberry', 'fig'];
13    echo "元の配列:\n";
14    print_r($items);
15
16    // 1. unset() を使ってキー（インデックス）を指定して要素を削除
17    // この方法は指定されたキーの要素を削除しますが、数値キーは再インデックスされません。
18    unset($items[1]); // 'banana' を削除
19    echo "\nunset(\$items[1]) で 'banana' を削除後:\n";
20    print_r($items);
21
22    // unset() の後、数値キーを再インデックスしたい場合は array_values() を使用
23    $items = array_values($items);
24    echo "\narray_values() で再インデックス後:\n";
25    print_r($items);
26
27    // 2. array_filter() を使って値に基づいて要素を削除
28    // 特定の条件を満たさない要素を除外して新しい配列を作成します。
29    // ここでは 'date' を削除します。PHP 8 のアロー関数 (fn) を使用。
30    $items = array_filter($items, fn($value) => $value !== 'date');
31    // array_filter() はキーを保持するため、再インデックスが必要な場合は array_values() を使用
32    $items = array_values($items);
33    echo "\narray_filter() で 'date' を削除後:\n";
34    print_r($items);
35
36    // 3. array_splice() を使って特定の範囲の要素を削除
37    // 配列の指定された位置から、指定された数の要素を削除します。
38    // 数値キーは自動的に再インデックスされます。
39    // ここでは現在のインデックス2から2つの要素 ('elderberry', 'fig') を削除します。
40    array_splice($items, 2, 2);
41    echo "\narray_splice(\$items, 2, 2) で2つの要素を削除後:\n";
42    print_r($items);
43
44    echo "\n最終的な配列:\n";
45    print_r($items);
46}
47
48// 例示関数を実行
49deleteElementsFromArrayExample();
50

このサンプルコードは、PHPで配列から要素を削除する主な方法を、システムエンジニアを目指す初心者向けに解説しています。

まず、unset() 関数は、配列の特定のキー（インデックス）を指定して要素を削除します。この関数は、指定された変数を破棄するもので、配列から要素を削除した場合は true を返しますが、通常は戻り値を確認せず使用されます。元の配列から要素を直接削除しますが、数値キーが自動的に再インデックスされないため、連続した数値キーが必要な場合は、削除後に array_values() 関数を使ってキーを振り直す必要があります。array_values() は、配列の値のみを含む新しい数値添字配列を返します。

次に、array_filter() 関数は、コールバック関数で定義された条件を満たさない要素を配列から除外し、新しい配列を生成する方法です。コールバック関数は各要素に対して実行され、true を返した要素のみが新しい配列に残されます。array_filter() は新しい配列を戻り値として返し、元の配列は変更されません。この関数もキーを保持するため、再インデックスが必要な場合は array_values() を適用します。

最後に、array_splice() 関数は、配列の指定した開始位置から指定した数の要素を削除する強力な方法です。この関数は元の配列を直接変更し、削除された要素を新しい配列として戻り値で返します。array_splice() の利点は、要素を削除した際に数値キーが自動的に再インデックスされる点です。

これらの関数を適切に使い分けることで、PHPの配列から柔軟に要素を削除できます。