［PHP］rtrim関数の使い方を徹底解説!文字列の右側トリミングをマスター

PHPで文字列を扱う際、末尾の不要な空白や特定の文字を削除したい場面がよくあります。ユーザー入力の整形、ファイルパスの正規化、データのクリーニングなど、様々な用途で末尾のトリミングが必要です。この記事では、PHPのrtrim関数について、基本的な使い方から実践的な活用方法まで詳しく解説していきます。

rtrim関数とは?

rtrimは、文字列の**右側（末尾）**から指定した文字を削除する関数です。デフォルトでは空白文字を削除しますが、任意の文字を指定することもできます。

基本的な構文

string rtrim(string $string, string $characters = " \n\r\t\v\0")

パラメータ:

$string: トリミングする文字列
$characters: 削除する文字のリスト（省略時はデフォルトの空白文字）

戻り値:

右側（末尾）から指定した文字を削除した文字列

デフォルトで削除される文字:

" " – 通常のスペース
"\n" – 改行（LF）
"\r" – 復帰（CR）
"\t" – タブ
"\v" – 垂直タブ
"\0" – NULLバイト

基本的な使い方

末尾の空白を削除

<?php
// 末尾のスペースを削除
$text = "Hello World   ";
$trimmed = rtrim($text);
echo "[{$trimmed}]";  // 出力: [Hello World]

// 末尾の改行を削除
$text = "Line 1\nLine 2\n";
$trimmed = rtrim($text);
echo "[{$trimmed}]";  // 出力: [Line 1\nLine 2]

// 末尾のタブを削除
$text = "Data\t\t";
$trimmed = rtrim($text);
echo "[{$trimmed}]";  // 出力: [Data]
?>

特定の文字を削除

<?php
// 末尾のスラッシュを削除
$url = "https://example.com/path/";
$trimmed = rtrim($url, '/');
echo $trimmed;  // 出力: https://example.com/path

// 末尾のカンマを削除
$csv = "apple,banana,cherry,";
$trimmed = rtrim($csv, ',');
echo $trimmed;  // 出力: apple,banana,cherry

// 末尾のピリオドを削除
$sentence = "This is a sentence...";
$trimmed = rtrim($sentence, '.');
echo $trimmed;  // 出力: This is a sentence
?>

複数の文字を削除

<?php
// 末尾のスペース、改行、タブを削除（デフォルト動作）
$text = "Hello\n\t  ";
$trimmed = rtrim($text);
echo "[{$trimmed}]";  // 出力: [Hello]

// 末尾の数字を削除
$code = "ABC123456";
$trimmed = rtrim($code, '0123456789');
echo $trimmed;  // 出力: ABC

// 末尾の記号を削除
$text = "Text!!!???";
$trimmed = rtrim($text, '!?');
echo $trimmed;  // 出力: Text
?>

trim、ltrimとの違い

比較例

<?php
$text = "  Hello World  ";

// trim() - 両端から削除
echo "[" . trim($text) . "]";    // 出力: [Hello World]

// ltrim() - 左側（先頭）から削除
echo "[" . ltrim($text) . "]";   // 出力: [Hello World  ]

// rtrim() - 右側（末尾）から削除
echo "[" . rtrim($text) . "]";   // 出力: [  Hello World]
?>

使い分けの指針

<?php
// ユーザー入力の正規化 → trim()
$input = trim($_POST['username']);

// ファイルパスの正規化 → rtrim()
$path = rtrim($baseDir, '/') . '/' . $filename;

// 行頭のインデント削除 → ltrim()
$code = ltrim($line);

// カスタムトリミング → 用途に応じて選択
$url = rtrim($url, '/');
?>

実践的な使用例

1. ファイルパス操作

<?php
/**
 * パス操作ユーティリティクラス
 */
class PathHelper {
    
    /**
     * パスを結合（末尾のスラッシュを正規化）
     */
    public static function join(...$parts) {
        $paths = [];
        
        foreach ($parts as $part) {
            if ($part !== '') {
                $paths[] = rtrim($part, '/\\');
            }
        }
        
        return implode('/', $paths);
    }
    
    /**
     * URLを正規化（末尾のスラッシュを削除）
     */
    public static function normalizeUrl($url) {
        // プロトコル部分は保持
        $parts = parse_url($url);
        
        if (isset($parts['path'])) {
            $parts['path'] = rtrim($parts['path'], '/');
        }
        
        $normalized = $parts['scheme'] . '://' . $parts['host'];
        
        if (isset($parts['path']) && $parts['path'] !== '') {
            $normalized .= $parts['path'];
        }
        
        if (isset($parts['query'])) {
            $normalized .= '?' . $parts['query'];
        }
        
        return $normalized;
    }
    
    /**
     * ファイル拡張子を削除
     */
    public static function removeExtension($filename) {
        $lastDot = strrpos($filename, '.');
        
        if ($lastDot === false) {
            return $filename;
        }
        
        return substr($filename, 0, $lastDot);
    }
    
    /**
     * ディレクトリの末尾スラッシュを保証
     */
    public static function ensureTrailingSlash($path) {
        return rtrim($path, '/\\') . '/';
    }
}

// 使用例
echo "=== ファイルパス操作 ===\n";

$path = PathHelper::join('/var/www/', '/html/', 'index.php');
echo "結合パス: {$path}\n";

$url = PathHelper::normalizeUrl('https://example.com/path//');
echo "正規化URL: {$url}\n";

$filename = PathHelper::removeExtension('document.pdf');
echo "拡張子削除: {$filename}\n";

$dir = PathHelper::ensureTrailingSlash('/var/www/html');
echo "末尾スラッシュ保証: {$dir}\n";
?>

2. CSV/TSVデータの整形

<?php
/**
 * CSVデータ処理クラス
 */
class CsvProcessor {
    
    /**
     * CSV行を解析（末尾のカンマを処理）
     */
    public static function parseLine($line) {
        // 末尾の改行とカンマを削除
        $line = rtrim($line, "\n\r");
        $line = rtrim($line, ',');
        
        return explode(',', $line);
    }
    
    /**
     * CSVデータをクリーンアップ
     */
    public static function cleanCsvData($data) {
        $lines = explode("\n", $data);
        $cleaned = [];
        
        foreach ($lines as $line) {
            // 末尾の空白とカンマを削除
            $line = rtrim($line);
            $line = rtrim($line, ',');
            
            if ($line !== '') {
                $cleaned[] = $line;
            }
        }
        
        return implode("\n", $cleaned);
    }
    
    /**
     * 各フィールドの末尾空白を削除
     */
    public static function trimFields($row) {
        return array_map(function($field) {
            return rtrim(ltrim($field));
        }, $row);
    }
    
    /**
     * CSVを配列に変換
     */
    public static function toArray($csvString) {
        $lines = explode("\n", $csvString);
        $result = [];
        
        foreach ($lines as $line) {
            $line = rtrim($line, "\n\r");
            
            if ($line !== '') {
                $fields = self::trimFields(explode(',', $line));
                $result[] = $fields;
            }
        }
        
        return $result;
    }
}

// 使用例
echo "\n=== CSV処理 ===\n";

$csvData = "name,age,city,\njohn,30,tokyo,\njane,25,osaka,\n";

echo "元のCSV:\n{$csvData}\n";

$cleaned = CsvProcessor::cleanCsvData($csvData);
echo "\nクリーンアップ後:\n{$cleaned}\n";

$array = CsvProcessor::toArray($csvData);
echo "\n配列変換:\n";
print_r($array);
?>

3. テキスト整形

<?php
/**
 * テキスト整形クラス
 */
class TextFormatter {
    
    /**
     * 末尾の句読点を削除
     */
    public static function removePunctuation($text) {
        return rtrim($text, '.,!?;:');
    }
    
    /**
     * 末尾の括弧を削除
     */
    public static function removeBrackets($text) {
        return rtrim(ltrim($text, '([{'), ')]}');
    }
    
    /**
     * 末尾の数字を削除
     */
    public static function removeTrailingNumbers($text) {
        return rtrim($text, '0123456789');
    }
    
    /**
     * 複数行テキストの各行末尾を整形
     */
    public static function trimLines($text) {
        $lines = explode("\n", $text);
        $trimmed = array_map('rtrim', $lines);
        return implode("\n", $trimmed);
    }
    
    /**
     * 末尾の重複文字を削除
     */
    public static function removeDuplicateTrailing($text, $char) {
        while (strlen($text) > 0 && substr($text, -1) === $char) {
            $text = rtrim($text, $char);
            if (strlen($text) > 0 && substr($text, -1) !== $char) {
                break;
            }
        }
        return $text;
    }
    
    /**
     * 文章の末尾を整える
     */
    public static function cleanSentenceEnd($text) {
        // 末尾の空白を削除
        $text = rtrim($text);
        
        // 末尾に句点がない場合は追加
        if (!in_array(substr($text, -1), ['.', '。', '!', '?'])) {
            $text .= '。';
        }
        
        return $text;
    }
}

// 使用例
echo "\n=== テキスト整形 ===\n";

$text = "Hello World!!!";
echo "句読点削除: " . TextFormatter::removePunctuation($text) . "\n";

$text = "example123";
echo "末尾の数字削除: " . TextFormatter::removeTrailingNumbers($text) . "\n";

$multiline = "Line 1   \nLine 2\t\t\nLine 3  ";
echo "各行末尾整形:\n" . TextFormatter::trimLines($multiline) . "\n";

$text = "Text.....";
echo "重複削除: " . TextFormatter::removeDuplicateTrailing($text, '.') . "\n";

$sentence = "これはテストです";
echo "文末整形: " . TextFormatter::cleanSentenceEnd($sentence) . "\n";
?>

4. ログ処理

<?php
/**
 * ログ処理クラス
 */
class LogProcessor {
    
    /**
     * ログファイルを読み込んで整形
     */
    public static function readAndClean($logFile) {
        if (!file_exists($logFile)) {
            return [];
        }
        
        $lines = file($logFile);
        $cleaned = [];
        
        foreach ($lines as $line) {
            // 末尾の改行を削除
            $line = rtrim($line, "\n\r");
            
            if ($line !== '') {
                $cleaned[] = $line;
            }
        }
        
        return $cleaned;
    }
    
    /**
     * ログエントリをパース
     */
    public static function parseEntry($entry) {
        // 末尾の空白を削除
        $entry = rtrim($entry);
        
        // タイムスタンプとメッセージを分離
        if (preg_match('/^\[([^\]]+)\]\s*(.+)$/', $entry, $matches)) {
            return [
                'timestamp' => $matches[1],
                'message' => rtrim($matches[2])
            ];
        }
        
        return ['timestamp' => '', 'message' => $entry];
    }
    
    /**
     * ログをフィルタリング
     */
    public static function filterByLevel($entries, $level) {
        return array_filter($entries, function($entry) use ($level) {
            $entry = rtrim($entry);
            return stripos($entry, $level) !== false;
        });
    }
    
    /**
     * 末尾の空行を削除
     */
    public static function removeEmptyTrailingLines($text) {
        $lines = explode("\n", $text);
        
        // 末尾から空行を削除
        while (count($lines) > 0 && trim(end($lines)) === '') {
            array_pop($lines);
        }
        
        return implode("\n", $lines);
    }
}

// 使用例
echo "\n=== ログ処理 ===\n";

// サンプルログデータ
$logData = "[2024-01-15 10:30:45] INFO: Application started   \n[2024-01-15 10:30:46] DEBUG: Loading config   \n[2024-01-15 10:30:47] ERROR: Database connection failed   \n\n\n";

echo "元のログ:\n{$logData}---\n";

$cleaned = LogProcessor::removeEmptyTrailingLines($logData);
echo "\n空行削除後:\n{$cleaned}\n---\n";

$entries = explode("\n", $cleaned);
foreach ($entries as $entry) {
    if (trim($entry) !== '') {
        $parsed = LogProcessor::parseEntry($entry);
        echo "\n[{$parsed['timestamp']}] {$parsed['message']}";
    }
}
?>

5. URL・クエリ文字列の処理

<?php
/**
 * URL処理クラス
 */
class UrlHelper {
    
    /**
     * クエリ文字列から末尾の&を削除
     */
    public static function cleanQueryString($query) {
        return rtrim($query, '&');
    }
    
    /**
     * URLパラメータを構築
     */
    public static function buildQueryString($params) {
        $parts = [];
        
        foreach ($params as $key => $value) {
            $parts[] = urlencode($key) . '=' . urlencode($value);
        }
        
        return rtrim(implode('&', $parts), '&');
    }
    
    /**
     * URLを正規化
     */
    public static function normalize($url) {
        // 末尾のスラッシュとクエリ区切り文字を整理
        $parts = parse_url($url);
        $normalized = '';
        
        if (isset($parts['scheme'])) {
            $normalized .= $parts['scheme'] . '://';
        }
        
        if (isset($parts['host'])) {
            $normalized .= $parts['host'];
        }
        
        if (isset($parts['path'])) {
            $path = rtrim($parts['path'], '/');
            if ($path !== '') {
                $normalized .= $path;
            }
        }
        
        if (isset($parts['query'])) {
            $normalized .= '?' . self::cleanQueryString($parts['query']);
        }
        
        return $normalized;
    }
    
    /**
     * パンくずリストのパスを生成
     */
    public static function generateBreadcrumbs($path) {
        $path = rtrim($path, '/');
        $parts = explode('/', $path);
        $breadcrumbs = [];
        $current = '';
        
        foreach ($parts as $part) {
            if ($part !== '') {
                $current .= '/' . $part;
                $breadcrumbs[] = [
                    'label' => $part,
                    'path' => $current
                ];
            }
        }
        
        return $breadcrumbs;
    }
}

// 使用例
echo "\n=== URL処理 ===\n";

$query = "name=john&age=30&city=tokyo&";
echo "クエリ整形: " . UrlHelper::cleanQueryString($query) . "\n";

$params = ['search' => 'php', 'page' => '2', 'sort' => 'date'];
echo "クエリ構築: " . UrlHelper::buildQueryString($params) . "\n";

$url = "https://example.com/path/to/page/?param=value&";
echo "URL正規化: " . UrlHelper::normalize($url) . "\n";

echo "\nパンくずリスト:\n";
$breadcrumbs = UrlHelper::generateBreadcrumbs('/products/electronics/computers/');
foreach ($breadcrumbs as $crumb) {
    echo "  {$crumb['label']} → {$crumb['path']}\n";
}
?>

6. データベースクエリの整形

<?php
/**
 * SQLクエリビルダー
 */
class QueryBuilder {
    private $query = '';
    
    /**
     * SELECTを追加
     */
    public function select($columns = '*') {
        $this->query = "SELECT {$columns}";
        return $this;
    }
    
    /**
     * FROMを追加
     */
    public function from($table) {
        $this->query .= " FROM {$table}";
        return $this;
    }
    
    /**
     * WHEREを追加
     */
    public function where($conditions) {
        if (!empty($conditions)) {
            $this->query .= " WHERE " . rtrim($conditions, ' AND');
        }
        return $this;
    }
    
    /**
     * ORDERを追加
     */
    public function orderBy($column, $direction = 'ASC') {
        $this->query .= " ORDER BY {$column} {$direction}";
        return $this;
    }
    
    /**
     * クエリを取得
     */
    public function build() {
        // 末尾の不要な空白とセミコロンを削除
        return rtrim(rtrim($this->query), ';');
    }
    
    /**
     * 条件を構築
     */
    public static function buildConditions($conditions) {
        $parts = [];
        
        foreach ($conditions as $field => $value) {
            $parts[] = "{$field} = " . (is_numeric($value) ? $value : "'{$value}'");
        }
        
        return rtrim(implode(' AND ', $parts), ' AND');
    }
}

// 使用例
echo "\n=== SQLクエリ構築 ===\n";

$query = (new QueryBuilder())
    ->select('id, name, email')
    ->from('users')
    ->where('status = 1 AND age > 18 AND')
    ->orderBy('created_at', 'DESC')
    ->build();

echo "構築されたクエリ:\n{$query}\n";

$conditions = QueryBuilder::buildConditions([
    'status' => 1,
    'role' => 'admin',
    'active' => 1
]);

echo "\n条件文字列: {$conditions}\n";
?>

よくある間違いと注意点

間違い1: 文字リストの理解不足

<?php
// ❌ "abc"という文字列全体ではなく、各文字が削除される
$text = "testabcabc";
$result = rtrim($text, 'abc');
echo $result;  // 出力: test（末尾のa,b,cがすべて削除される）

// ✅ 特定の文字列を削除したい場合
$text = "testabcabc";
if (str_ends_with($text, 'abc')) {
    $result = substr($text, 0, -3);
}
?>

間違い2: マルチバイト文字の扱い

<?php
// マルチバイト文字には注意
$text = "こんにちは　　";  // 全角スペース

// rtrimは全角スペースを削除しない
$result = rtrim($text);
echo "[{$result}]";  // [こんにちは　　]

// ✅ 全角スペースも削除する場合
$result = rtrim($text, " \n\r\t\v\0　");  // 全角スペースを追加
echo "[{$result}]";  // [こんにちは]

// または mb_ereg_replace を使用
$result = mb_ereg_replace('[\s　]+$', '', $text);
?>

間違い3: 参照渡しではない

<?php
$text = "Hello   ";

// ❌ rtrimは元の変数を変更しない
rtrim($text);
echo "[{$text}]";  // [Hello   ] 変更されていない

// ✅ 戻り値を使用
$text = rtrim($text);
echo "[{$text}]";  // [Hello]
?>