浏览器

免费插件

此插件免费开源，采用 MIT 许可证。

概述

Browser API 提供三种打开 URL 的方法，分别针对不同的使用场景：应用内浏览、系统浏览器导航和 Web 认证流程。

安装

composer require nativephp/mobile-browser

使用

PHP (Livewire/Blade)

use Native\Mobile\Facades\Browser;

// 在应用内浏览器中打开
Browser::inApp('https://nativephp.com/mobile');

// 在系统浏览器中打开
Browser::open('https://nativephp.com/mobile');

// OAuth 认证
Browser::auth('https://provider.com/oauth/authorize?client_id=123&redirect_uri=nativephp://127.0.0.1/auth/callback');

JavaScript (Vue/React/Inertia)

import { browser } from '#nativephp';

// 在应用内浏览器中打开
await browser.inApp('https://nativephp.com/mobile');

// 在系统浏览器中打开
await browser.open('https://nativephp.com/mobile');

// OAuth 认证
await browser.auth('https://provider.com/oauth/authorize?client_id=123&redirect_uri=nativephp://127.0.0.1/auth/callback');

方法

inApp()

使用 Custom Tabs (Android) 或 SFSafariViewController (iOS) 在应用内嵌入式浏览器中打开 URL。

open()

在设备的默认浏览器应用中打开 URL，完全离开你的应用程序。

auth()

在专门用于 OAuth 流程的认证浏览器中打开 URL，自动处理 nativephp:// 重定向。

使用场景

何时使用各方法

inApp() - 让用户保持在应用体验中：

• 文档、帮助页面、服务条款
• 与应用相关的外部内容
• 当你希望用户能轻松返回应用时

open() - 需要完整浏览器体验：

• 复杂的 Web 应用
• 需要特定浏览器功能的内容
• 当用户需要书签或分享功能时

auth() - OAuth 认证流程：

• 使用 WorkOS、Auth0、Google、Facebook 等登录
• 带自动重定向的安全认证
• 用于安全的隔离浏览器会话