PHP中VarnishAdmin::ban 什么意思？如何使用？

摘要

VarnishAdmin::ban 方法用于在 Varnish 缓存中禁止列出的 URL 路径。它阻止 Varnish 为这些路径提供已缓存的内容，并强制浏览器或客户端从源服务器获取新的内容。

详细说明

语法

public function ban($urls, $duration = null, $grace = null, $peek = false) : void

参数

• $urls (array|string): 要禁止的 URL 路径的数组或单个字符串。
• $duration (int): 禁止的持续时间（以秒为单位）。默认值为 0，表示永久禁止。
• $grace (int): 宽限期（以秒为单位），在此期间客户端仍可以访问已缓存的内容。默认值为 60。
• $peek (bool): 是否仅预览要禁止的 URL，而不对缓存进行任何更改。默认值为 false。

说明

VarnishAdmin::ban 方法通过在 Varnish 缓存中创建一个 ACL（访问控制列表）来工作。ACL 标识了禁止访问的 URL 路径，并强制客户端从源服务器获取内容。

当客户端请求被禁止的 URL 路径时，Varnish 会检查 ACL，如果找到匹配项，则会阻止已缓存的内容并从源服务器获取新的内容。

此方法可用于强制刷新缓存中的特定内容，例如当内容已更新或不再有效时。通过指定持续时间，可以控制禁止的持续时间，并在需要时解除禁止。

宽限期允许客户端在禁止生效之前访问已缓存的内容。这对于避免对用户体验造成重大中断很有用。

範例

以下範例展示了如何使用 VarnishAdmin::ban 方法来禁止指定 URL 路径：

use VarnishAdminVarnishAdmin;

// 创建 Varnish 管理对象
$varnishAdmin = new VarnishAdmin("localhost", 6082);

// 禁止单个 URL 路径
$varnishAdmin->ban("/path/to/ban");

// 禁止多个 URL 路径
$varnishAdmin->ban([
    "/path/to/ban1",
    "/path/to/ban2",
    "/path/to/ban3",
]);

// 禁止 URL 路径并设置持续时间和宽限期
$varnishAdmin->ban("/path/to/ban", 3600, 60);

// 仅预览要禁止的 URL 路径
$varnishAdmin->ban("/path/to/ban", 0, 0, true);

请注意，在执行 VarnishAdmin::ban 方法后，需要重新加载 Varnish 配置才能使更改生效。

以上就是PHP中VarnishAdmin::ban 什么意思？如何使用？的详细内容，更多请关注编程网其它相关文章！