Laravel 10.17.1搭配最新Yajra Composer出现Yajra\Oci8\PDO未定义问题

问题概述 #

在Laravel 10.17.1中使用最新版Yajra Oci8包时，出现Undefined type 'Yajra\Oci8\PDO'或Class "Yajra\Oci8\PDO" not found错误，报错位置在app/Http/Controllers/OtherController.php第38行，已引入use Yajra\Oci8\PDO;且PHP 8.1.17已启用oci8扩展。

解决方案 #

1. 确认包版本兼容性 #

Laravel 10需要适配yajra/laravel-oci8的^10.0版本，检查composer.json中的依赖声明，若版本不符，执行以下命令重新安装适配版本：

composer require yajra/laravel-oci8:^10.0

2. 修正PDO类的使用方式 #

最新版Yajra Oci8已移除Yajra\Oci8\PDO类，需改用以下方式获取Oracle PDO连接：

• 使用Laravel DB门面（推荐）：

  use Illuminate\Support\Facades\DB;
  
  // 获取Oracle连接的PDO实例
  $pdo = DB::connection('oracle')->getPdo();
  

• 直接使用原生PDO：

  // 替换为你的Oracle连接信息
  $dsn = 'oci:dbname=//your-host:port/your-service-name';
  $username = 'your-username';
  $password = 'your-password';
  
  $pdo = new PDO($dsn, $username, $password);
  

3. 清理缓存 #

执行以下命令清除Laravel和Composer的缓存，确保类自动加载生效：

php artisan cache:clear
php artisan config:clear
php artisan optimize:clear
composer dump-autoload

4. 验证oci8扩展状态 #

通过命令行执行php -m，确认输出中包含oci8模块；也可通过phpinfo()查看oci8扩展的详细配置，确保扩展正常加载。

内容的提问来源于stack exchange，提问作者Nalawala Murtaza