［PHP］hebrev関数とは？ヘブライ語テキスト処理の基礎から実践まで【多言語対応】

Webアプリケーションの国際化において、右から左に書かれる言語（RTL言語）の処理は特別な配慮が必要です。特にヘブライ語は、古くからコンピューターでの表示に課題がありました。PHPのhebrev関数は、そんなヘブライ語テキストの処理を支援する専用関数です。

今回は、PHPのhebrev関数について、その歴史的背景から実際の使用方法、現代的な代替手段まで詳しく解説していきます。

hebrev関数とは？

hebrev関数は、ヘブライ語テキストの視覚的順序を論理的順序に変換するPHPの組み込み関数です。これは、古いシステムでヘブライ語が視覚的な順序で保存されていた時代の互換性を保つために提供されています。

基本構文

hebrev(string $hebrew_text, int $max_chars_per_line = 0): string

• $hebrew_text: 変換するヘブライ語テキスト
• $max_chars_per_line: 1行あたりの最大文字数（省略可能）

ヘブライ語の文字方向について

ヘブライ語を理解するために、まず文字の方向について説明します。

RTL（Right-to-Left）言語とは

<?php
// 英語（LTR - Left to Right）
$english = "Hello World";
echo $english; // 左から右に表示: Hello World

// ヘブライ語（RTL - Right to Left）
$hebrew = "שלום עולם"; // "Hello World" in Hebrew
echo $hebrew; // 右から左に表示される
?>

視覚的順序 vs 論理的順序

• 論理的順序: テキストが記述される順序（現代の標準）
• 視覚的順序: 画面に表示される順序（古いシステムで使用）

<?php
// 例：「ABC」というヘブライ語文字列があるとき
$logical_order = "אבג";   // 論理的順序（正しい保存形式）
$visual_order = "גבא";    // 視覚的順序（古い形式）

// hebrev関数は視覚的順序→論理的順序に変換
$converted = hebrev($visual_order);
echo $converted; // "אבג" が出力される
?>

hebrev関数の実際の使用例

1. 基本的な文字列変換

<?php
// 視覚的順序で保存されたヘブライ語テキスト
$visual_hebrew = "םולש";  // "שלום"（平和）の視覚的順序

// 論理的順序に変換
$logical_hebrew = hebrev($visual_hebrew);
echo "変換前: " . $visual_hebrew . "\n";
echo "変換後: " . $logical_hebrew . "\n";

// 結果:
// 変換前: םולש
// 変換後: שלום
?>

2. 行の長さ制限付き変換

<?php
$long_hebrew_text = "םולש תירבעה הפשב בותכ ךורא טסקט";

// 10文字ごとに改行を挿入
$formatted = hebrev($long_hebrew_text, 10);
echo $formatted;

// より実用的な例：HTML出力での使用
function formatHebrewForDisplay($text, $maxChars = 50) {
    $converted = hebrev($text, $maxChars);
    return "<div dir='rtl' lang='he'>" . htmlspecialchars($converted) . "</div>";
}

$hebrewText = "םולש תירבעה הפשב בותכ ךורא טסקט הז";
echo formatHebrewForDisplay($hebrewText);
?>

3. データベースからの古いデータ処理

<?php
class HebrewTextProcessor {
    private $pdo;
    
    public function __construct($database) {
        $this->pdo = new PDO($database);
    }
    
    // 古いシステムからのヘブライ語データを変換
    public function convertLegacyHebrewData($tableName, $columnName) {
        try {
            // 古いデータを取得
            $stmt = $this->pdo->prepare("SELECT id, {$columnName} FROM {$tableName} WHERE {$columnName} IS NOT NULL");
            $stmt->execute();
            
            $updatedCount = 0;
            
            while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
                $originalText = $row[$columnName];
                
                // ヘブライ語テキストかどうかをチェック
                if ($this->isHebrewText($originalText)) {
                    $convertedText = hebrev($originalText);
                    
                    // 変換されたテキストをデータベースに更新
                    $updateStmt = $this->pdo->prepare("UPDATE {$tableName} SET {$columnName} = ? WHERE id = ?");
                    $updateStmt->execute([$convertedText, $row['id']]);
                    
                    $updatedCount++;
                }
            }
            
            return $updatedCount;
            
        } catch (PDOException $e) {
            throw new Exception("データベースエラー: " . $e->getMessage());
        }
    }
    
    // ヘブライ語テキストかどうかを判定
    private function isHebrewText($text) {
        // ヘブライ語文字のUnicode範囲をチェック
        return preg_match('/[\x{0590}-\x{05FF}]/u', $text);
    }
    
    // 変換前後の比較表示
    public function compareTexts($originalText) {
        $converted = hebrev($originalText);
        
        return [
            'original' => $originalText,
            'converted' => $converted,
            'is_hebrew' => $this->isHebrewText($originalText),
            'length_original' => mb_strlen($originalText),
            'length_converted' => mb_strlen($converted)
        ];
    }
}

// 使用例
try {
    $processor = new HebrewTextProcessor('sqlite:legacy_database.db');
    
    // 古いニュース記事のタイトルを変換
    $updatedCount = $processor->convertLegacyHebrewData('news_articles', 'title');
    echo "変換完了: {$updatedCount}件のレコードを更新しました\n";
    
    // 個別テキストの比較
    $testText = "תוחדא ירבח";
    $comparison = $processor->compareTexts($testText);
    print_r($comparison);
    
} catch (Exception $e) {
    echo "エラー: " . $e->getMessage();
}
?>

現代的なヘブライ語処理

1. UTF-8とUnicodeの活用

現代のWebアプリケーションでは、hebrev関数よりもUTF-8エンコーディングとUnicodeを使用することが推奨されます。

<?php
// 現代的なヘブライ語処理
function modernHebrewDisplay($text) {
    // UTF-8エンコーディングを確保
    if (!mb_check_encoding($text, 'UTF-8')) {
        $text = mb_convert_encoding($text, 'UTF-8');
    }
    
    // HTMLでの適切な表示
    return sprintf(
        '<div dir="rtl" lang="he" style="text-align: right; font-family: Arial, sans-serif;">%s</div>',
        htmlspecialchars($text, ENT_QUOTES, 'UTF-8')
    );
}

// 使用例
$modernHebrew = "שלום עולם! זה טקסט בעברית.";
echo modernHebrewDisplay($modernHebrew);
?>

2. 国際化（i18n）対応

<?php
class MultiLanguageSupport {
    private $supportedLanguages = [
        'he' => ['name' => 'Hebrew', 'dir' => 'rtl', 'charset' => 'UTF-8'],
        'ar' => ['name' => 'Arabic', 'dir' => 'rtl', 'charset' => 'UTF-8'],
        'en' => ['name' => 'English', 'dir' => 'ltr', 'charset' => 'UTF-8'],
        'ja' => ['name' => 'Japanese', 'dir' => 'ltr', 'charset' => 'UTF-8']
    ];
    
    public function formatText($text, $language) {
        if (!isset($this->supportedLanguages[$language])) {
            throw new InvalidArgumentException("Unsupported language: {$language}");
        }
        
        $config = $this->supportedLanguages[$language];
        
        // 古いヘブライ語データの場合のみhebrevを使用
        if ($language === 'he' && $this->isLegacyHebrewFormat($text)) {
            $text = hebrev($text);
        }
        
        return sprintf(
            '<div dir="%s" lang="%s" class="text-%s">%s</div>',
            $config['dir'],
            $language,
            $language,
            htmlspecialchars($text, ENT_QUOTES, $config['charset'])
        );
    }
    
    private function isLegacyHebrewFormat($text) {
        // 古い形式かどうかを判定するロジック
        // 実際の実装では、より詳細な検証が必要
        return false; // 簡略化
    }
    
    public function getSupportedLanguages() {
        return $this->supportedLanguages;
    }
}

// 使用例
$multilang = new MultiLanguageSupport();

$texts = [
    'he' => 'שלום עולם',
    'ar' => 'مرحبا بالعالم',
    'en' => 'Hello World',
    'ja' => 'こんにちは世界'
];

foreach ($texts as $lang => $text) {
    echo $multilang->formatText($text, $lang) . "\n";
}
?>

実用的なWebアプリケーションでの活用

1. CMS（コンテンツ管理システム）での利用

<?php
class HebrewContentManager {
    private $db;
    
    public function __construct($database) {
        $this->db = $database;
    }
    
    // コンテンツの保存時に適切な形式に変換
    public function saveContent($title, $content, $language = 'he') {
        // 古い形式のヘブライ語の場合は変換
        if ($language === 'he') {
            $title = $this->processHebrewText($title);
            $content = $this->processHebrewText($content);
        }
        
        $stmt = $this->db->prepare("
            INSERT INTO contents (title, content, language, created_at) 
            VALUES (?, ?, ?, NOW())
        ");
        
        return $stmt->execute([$title, $content, $language]);
    }
    
    private function processHebrewText($text) {
        // 必要に応じてhebrevを適用
        if ($this->needsConversion($text)) {
            return hebrev($text);
        }
        return $text;
    }
    
    private function needsConversion($text) {
        // 変換が必要かどうかの判定ロジック
        // 実際のプロジェクトでは、より詳細な検証が必要
        return false;
    }
    
    // コンテンツの表示
    public function displayContent($id) {
        $stmt = $this->db->prepare("SELECT * FROM contents WHERE id = ?");
        $stmt->execute([$id]);
        $content = $stmt->fetch(PDO::FETCH_ASSOC);
        
        if (!$content) {
            return null;
        }
        
        // 言語に応じた表示処理
        $direction = ($content['language'] === 'he' || $content['language'] === 'ar') ? 'rtl' : 'ltr';
        
        return sprintf(
            '<article dir="%s" lang="%s">
                <h1>%s</h1>
                <div class="content">%s</div>
            </article>',
            $direction,
            $content['language'],
            htmlspecialchars($content['title']),
            htmlspecialchars($content['content'])
        );
    }
}
?>

注意点と制限事項

1. 現代開発での位置づけ

<?php
// ❌ 推奨されない使い方（現代の開発では）
function oldStyleHebrewProcessing($text) {
    return hebrev($text); // 単純な変換のみ
}

// ✅ 推奨される現代的なアプローチ
function modernHebrewProcessing($text, $options = []) {
    // 1. エンコーディングチェック
    if (!mb_check_encoding($text, 'UTF-8')) {
        $text = mb_convert_encoding($text, 'UTF-8');
    }
    
    // 2. 古い形式の場合のみhebrevを適用
    if (isset($options['legacy']) && $options['legacy']) {
        $text = hebrev($text, $options['max_chars'] ?? 0);
    }
    
    // 3. HTMLエスケープ
    $text = htmlspecialchars($text, ENT_QUOTES, 'UTF-8');
    
    // 4. 適切なHTMLマークアップ
    return sprintf(
        '<span dir="rtl" lang="he">%s</span>',
        $text
    );
}
?>

2. パフォーマンスの考慮

<?php
class HebrewTextCache {
    private $cache = [];
    
    public function processText($text, $useHebrev = false) {
        $cacheKey = md5($text . ($useHebrev ? '_hebrev' : ''));
        
        if (isset($this->cache[$cacheKey])) {
            return $this->cache[$cacheKey];
        }
        
        $processed = $useHebrev ? hebrev($text) : $text;
        $this->cache[$cacheKey] = $processed;
        
        return $processed;
    }
    
    public function clearCache() {
        $this->cache = [];
    }
}
?>

まとめ

hebrev関数は、PHPにおけるヘブライ語テキスト処理のための歴史的に重要な関数です。現代のWebアプリケーション開発では直接使用する機会は少なくなりましたが、以下のような場面で今でも価値があります。

重要なポイント：

• レガシーシステム対応: 古いシステムからのデータ移行時
• UTF-8との併用: 現代的なUnicode処理と組み合わせて使用
• 適切なHTML出力: dir="rtl"属性と組み合わせた表示
• パフォーマンス: 大量のテキスト処理時はキャッシュを活用
• 多言語対応: 国際化の一環として他のRTL言語処理と統合

現代のWebアプリケーション開発では、UTF-8エンコーディングとCSSのdirectionプロパティを使用することが一般的ですが、hebrev関数は特定の状況下で今でも有用なツールです。特に、古いシステムとの互換性を保ちながら多言語対応を実現する際には、重要な役割を果たします。