README

请确保已全局安装 Composer，具体请参阅 Composer 文档中的安装章节。

使用 Symfony Flex 的应用程序

打开命令行控制台，进入您的项目目录并执行

$ composer require mluex/gravatar-bundle

打开命令行控制台，进入您的项目目录并执行以下命令以下载此 Bundle 的最新稳定版本

$ composer require mluex/gravatar-bundle

然后，通过将其添加到项目 config/bundles.php 文件中注册的 Bundle 列表来启用该 Bundle

// config/bundles.php

return [
    // ...
    Mluex\GravatarBundle\MluexGravatarBundle::class => ['all' => true],
];

如果您始终希望为 gravatars 设置一些默认值，例如大小、评分或默认值，可以在您的配置中进行设置

# config/packages/mluex_gravatar.yml
mluex_gravatar:
  rating: g
  size: 80
  default: mm

您只需使用如下示例中的辅助函数即可

<img src="<?php echo $view['gravatar']->getUrl('alias@domain.tld') ?>" />

或使用参数

<img src="<?php echo $view['gravatar']->getUrl('alias@domain.tld', '80', 'g', 'defaultimage.png', true) ?>" />

唯一必需的参数是电子邮件地址。其余参数都有默认值。

如果您使用 twig，可以使用如下示例中的辅助函数

<img src="{{ gravatar('alias@domain.tld') }}" />

或如果您想检查 gravatar 电子邮件是否存在

{% if gravatar_exists('alias@domain.tld') %}
  The email is an gravatar email
{% endif %}

或使用参数

<img src="{{ gravatar('alias@domain.tld', size, rating, default, secure) }}" />

有关更多信息，请参阅 gravatar 实现页面。