比较常用的方案是使用 grep 命令:

一、使用 grep 针对指定后缀的文件进行全文检索

grep 'some key words' -r ./some_folder --include=*.ext

二、使用 grep 搜索,匹配多个关键词。

grep -i -E "golang|dart|flutter|oraclecloud" -r ./some_folder

使用 fzf 工具进行搜索

SEO 优化最重要的事情之一就是建立反向链接。反向链接之所以重要,因为搜索引擎将反向链接视为有价值内容的投票内容。如果有很多网站链接到您的网站,搜索引擎更有可能在搜索结果中显示您的内容,从而提高您对链接主题的排名。

虽然有很多链接链到你到网站,担他们的价值并不相同,有一些链接来自权威的站点,有一些来自普通的站点,来自权威的可信度高站点的链接传递了比较高的权重,普通站点就低一点,google 通过一套算法来对这些链接传递的权重进行打分。

反向链接,有好的也有坏的

另一方面,也有一些链接,实质上对传递权重毫无用处,反而是一种有害的。这一类站点的特点是,低信任度,低质量,甚至被google 标记为垃圾站点,从索引中删除。他们不但可能损害您的网站得分,还有可能带来google 对站点的惩罚,这一类链接被称作“有毒链接”(Toxic link)。

google 是这样描述 toxic link 的:

在某些情况下,传入链接会影响谷歌对网页或网站的看法。例如,你或搜索引擎优化器(SEO)通过付费链接或其他链接构建到您网站的坏Ilink违反我们质量准则的计划。第一和最重要的是,我们建议您尽可能地删除垃圾邮件或低质量的链接。

ahref 站点有个更简单的划分:
  • 那些由链接站点编辑控制的链接,是良好的,高质量的。
  • 那些由机器自动生成的链接,无需编辑控制的,是差的,低质量的。

什么导致有毒链接

大概有以下几方面的原因,导致搜索引擎认为链接是低质量的,有毒的:

  • 域名的信任度很低:如果一个站点的反向链接的质量很低,很少有高信任度的站点传递过来的链接,那么该站点的信任度得分就会很低。
  • 做链接的页面:如果有很多站点,用很相似的内容,很相似的关键词,链接到你的站点,那么在搜索引擎看来,这可能是一个人为控制的链接建设方案。
  • 页面布局:如果网站页面布局中,文本的内容和 html 的所占的比例很低,在搜索引擎看来,页面的质量是比较低的。

有毒链接的危害

如果受到搜索引擎的处罚,它会降低您的网页排名。如果处罚足够严重,您的站点甚至会从索引中被删除。

谷歌在 2012 年推出了针对低质量链接的企鹅算法。使用链接建设方案的网站排名直线下降。从那时起,谷歌改进了算法,使其更擅长捕捉和惩罚不良链接。

如果企鹅看到链接有毒链接,它将根据您的链接配置文件应用惩罚。

除了企鹅,谷歌还为他们的垃圾邮件团队增加了更多的人力资源,他们可以手动惩罚具有有害反向链接的网站。有数据表明,谷歌每月发起超过 400,000 次手动操作。

手动链接审查和处罚可能由以下因素触发:

  • 来自竞争对手的垃圾邮件报告
  • 企鹅的算法活动触发人工审查
  • 您处于 Google 垃圾邮件团队活动监控的利基市场

如何找到有毒链接

一般来说,你需要借助一些工具,比如 semrush 或者 ahref。

如何清除有毒链接

您可以通过向 google 的 拒绝链接 提交要删除的链接或者域名。

参考:Toxic Backlinks - How They Hurt SEO, and How to Get Rid of Them

一、什么是闭包

闭包(Closures),又叫做匿名函数,也就是没有定义名字的函数,允许临时创建一个没有指定名称的函数,常用作回调函数(callable)参数的值。

  1. 闭包和匿名函数在 PHP5.3 中被引入。
  2. 闭包是指在创建时封装函数周围状态的函数,即使闭包所在的环境不存在了,闭包封装的状态依然存在。
  3. 闭包使用的语法和普通函数相同,但是本质上它是伪装成函数的对象,是 Closure 类的实例。闭包和字符串或整数一样,是一等值类型。
  4. PHP 闭包是对象,可以使用 $this 关键字获取闭包的内部状态。
  5. 闭包的默认状态里面有一个__invoke() 魔术方法和 bindTo() 方法。我们可以使用 bindTo() 方法把 Closure 对象内部状态绑定到其他对象上。bindTo() 方法的第二个参数可以指定绑定闭包的那个对象所属的 PHP 类,我们就可以访问这个类的受保护和私有的成员变量。

1. 闭包示例

<?php
  
echo preg_replace_callback('~-([a-z])~', function ($match) {
    return strtoupper($match[1]);
}, 'hello-world');

// 输出 helloWorld
?>

2. 闭包作为变量

闭包函数也可以作为变量的值来使用。PHP 会自动把此种表达式转换成内置类 Closure 的对象实例。把一个 closure 对象赋值给一个变量的方式与普通变量赋值的语法是一样的,最后也要加上分号。

<?php

$closure = function($name)
{
    printf("Hello %s\r\n", $name);
};

$closure('World');
$closure('PHP');

?>

我们之所以可以调用 $closure 变量,是因为这个变量的值是一个闭包,闭包对象实现了__invoke() 魔术方法,只要后面跟着 (),PHP 就会查找__invoke() 方法。

3. 闭包变量的作用域

闭包可以从父作用域中继承变量,变量必须在函数或类的头部声明。任何此类变量都应该用 use 语言结构传递进去。

PHP 7.1 起,不能传入此类变量: superglobals、 $this 或者和参数重名。

<?php
  
$message = 'hello';

// 没有 "use"
$example = function () {
    return $message;
};

echo $example(); // 输出 Undefined variable: message。

// 继承 $message
$example = function () use ($message) {
    return $message;
};

echo $example(); // 输出 hello

// 继承变量的值是定义时,而非调用时。
$message = 'world';

echo $example(); // 输出 hello

// 重新赋值
$message = 'hello';

// 重新定义
$example = function () use (&$message) {
    var_dump($message);
};

echo $example(); // 输出 hello

// 父级作用域的值变更,因为使用的是引用,所以闭包内部也会引起变化。
// is reflected inside the function call
$message = 'world'; 

echo $example(); // 输出 world

// 闭包也可以接受参数
$example = function ($arg) use ($message) {
    var_dump($arg . ' ' . $message);
};

$example("hello"); // 输出 hello world
?>

4. 闭包和作用域

从父作用域中继承变量与使用全局变量是不同的。

全局变量存在于一个全局的范围,无论当前在执行的是哪个函数。

闭包的父作用域是定义该闭包的函数(不一定是调用它的函数)。示例如下:

<?php

// 一个基本的购物车,包括一些已经添加的商品和每种商品的数量。
// 其中有一个方法用来计算购物车中所有商品的总价格,该方法使用了一个 closure 作为回调函数。

class Cart
{
    const PRICE_BUTTER  = 1.00;
    const PRICE_MILK    = 3.00;
    const PRICE_EGGS    = 6.95;

    protected   $products = array();
    
    public function add($product, $quantity)
    {
        $this->products[$product] = $quantity;
    }
    
    public function getQuantity($product)
    {
        return isset($this->products[$product]) ? $this->products[$product] :
               FALSE;
    }
    
    public function getTotal($tax)
    {
        $total = 0.00;
        // 闭包使用了父函数的环境变量 $tax, 和 $total
        $callback = function ($quantity, $product) use ($tax, &$total){
                $pricePerItem = constant(__CLASS__ . "::PRICE_" .strtoupper($product));
                $total += ($pricePerItem * $quantity) * ($tax + 1.0);
        };
        
        array_walk($this->products, $callback);
        return round($total, 2);;
    }
}

$my_cart = new Cart;

// 往购物车里添加条目
$my_cart->add('butter', 1);
$my_cart->add('milk', 3);
$my_cart->add('eggs', 6);

// 打出出总价格,其中有 5% 的销售税.
print $my_cart->getTotal(0.05) . "\n"; // 最后结果是 54.29
?>

5. 自动绑定 $this

闭包会自动绑定所在对象中的 $this,也就是说在闭包中可以访问到所在的对象。

<?php

class Test
{
    public function testing()
    {
        return function() {
            var_dump($this);
        };
    }
}

$object = new Test;
$function = $object->testing();
$function(); // 输出 object(Test)#1 (0) {}

6. 静态匿名函数

静态的匿名函数中,不能使用 $this。

<?php

class Foo
{
    function __construct()
    {
        $func = static function() {
            var_dump($this);
        };
        $func();
    }
};

new Foo(); // Using $this when not in object context

7. 静态闭包无法绑定到对象上

<?php

$func = static function() {
    echo  "hello";
};

$func = $func->bindTo(new StdClass);

$func(); //Cannot bind an instance to a static closure

二、闭包绑定到对象

闭包最开始主要是作为会调函数使用的,但是随着 php 语言的发展,有更多高级的用途,比如在 laravel 框架中,middleware,route 都主要的使用了闭包,通过绑定的方式能让开发人员在写业务逻辑的时候更加灵活。

Closure 类,包含两个方法:

  1. Closure::bind: 复制一个闭包,绑定指定的 $this 对象和类作用域。
  2. Closure::bindTo: 复制当前闭包对象,绑定指定的 $this 对象和类作用域。
Closure {   
    // closure:表示需要绑定的闭包对象。
    // newthis:表示需要绑定到闭包对象的对象,或者 NULL 创建未绑定的闭包。
    // newscope:表示想要绑定给闭包的类作用域,可以传入类名或类的示例,默认值是'static',表示不改变。
    public static Closure bind (Closure $closure , object $newthis [, mixed $newscope = 'static' ])  
    public Closure bindTo (object $newthis [, mixed $newscope = 'static' ])  
}

可以看下具体的例子,在闭包中可以调用预期绑定对象中的成员,创建闭包之后,再绑定到具体的对象上。

class Animal {  
    private static $cat = "cat";  
    private $dog = "dog";  
    public $pig = "pig";  
}  

/*  
 * 获取Animal类静态私有成员属性 
 */  
$cat = static function() {  
    return Animal::$cat;  
};  

/*  
 * 获取Animal实例私有成员属性 
 */  
$dog = function() {
    return $this->dog;  
};  

/*  
 * 获取Animal实例公有成员属性 
 */  
$pig = function() {  
    return $this->pig;  
};  

$bindCat = Closure::bind($cat, null, new Animal());// 给闭包绑定了Animal实例的作用域,但未给闭包绑定$this对象  
$bindDog = Closure::bind($dog, new Animal(), 'Animal');// 给闭包绑定了Animal类的作用域,同时将Animal实例对象作为$this对象绑定给闭包  
$bindPig = Closure::bind($pig, new Animal());// 将Animal实例对象作为$this对象绑定给闭包,保留闭包原有作用域  
echo $bindCat(),'<br>';// 根据绑定规则,允许闭包通过作用域限定操作符获取Animal类静态私有成员属性  
echo $bindDog(),'<br>';// 根据绑定规则,允许闭包通过绑定的$this对象(Animal实例对象)获取Animal实例私有成员属性  
echo $bindPig(),'<br>';// 根据绑定规则,允许闭包通过绑定的$this对象获取Animal实例公有成员属性

// bindTo与bind类似,是面向对象的调用方式,这里只举一个,其他类比就可以
$bindCat = $cat->bindTo(null, 'Animal');
$bindDog = $dog->bindTo(new Animal(), 'Animal');
$bindPig = $pig->bindTo(new Animal());

再看一下官方的例子,该例子展示了闭包更换绑定对象,从而改变其所处的环境:

class A {
  
    function __construct($val) {
        $this->val = $val;
    }
  
    function getClosure() {
        //返回绑定了该对象和作用域的闭包
        return function() { 
          return $this->val; 
        };
    }
}

// 创建对象 ob1
$ob1 = new A(1);

// 创建对象 ob2
$ob2 = new A(2);

// 获取对象 ob1 中的闭包 c1
$cl = $ob1->getClosure();
// 执行闭包
echo $cl(), "\n";

// 将 c1 绑定到 ob2
$cl = $cl->bindTo($ob2);
// 执行闭包
echo $cl(), "\n";

四、参考资料

一、写在前面

以前做过好几个站点涉及到社会化登录,主要使用的是 google,facebook。项目均采用 laravel 开发,使用官方插件 "laravel/socialite" 就 ok 了,如果遇到 socialite 中没有的 provider,则需前往 provider manager 仓库安装具体的 provider 了。

作为 web 项目,三方登录的 package 是比较成熟的,一般来说在网页上创建一个三方登录的按钮,跳转到第三方平台上登录,成功之后会跳转到项目站点预设的 callback 路径,在 callback 方法中做用户在三方平台登录之后在本站的认证操作。

近期,电商站点做 app,需要适配 app,一共要接入三个站点:facebook,google 和 paypal,本来以为 social 包就能处理,结果发现差异较大,浪费了不少的功夫,因此这里做点小结。

二、Facebook 登录

facebook 是最容易对接的,也是直接能用 socialite 包拿到用户数据的,app 那边登录之后,可以拿到 access_token,并传输到后端,后端拿到 access_token 后直接可以拿到用户的基本数据:

$userInfo = Socialite::driver($provider)->userFromToken($code);
$id = $userInfo->getId();
$name = $userInfo->getName();
$email = $userInfo->getEmail() ? $userInfo->getEmail() : $id;

三、google 登录

socialite 完全不能用,网上的文章也不靠谱。参考 google 官方文档 下载 google sdk 解决。

在所有工作开展之前,需要到 google 平台上增加项目,并对项目进行设置,此处略去不表。

用户在 google 登录之后,获得了名叫 id_token 的东西,客户端将 id_token 发送到后台服务器,服务器使用 id_token 获取用户信息。

这个 id_token,是和 access_token 是类似的东西,有效期内可以使用多次,还可以通过浏览器进行测试:

https://oauth2.googleapis.com/tokeninfo?id_token=XYZ123

在多次尝试 socialite 库解析用户数据无效之后,通过浏览器测试确认了 token 所携带的数据内容,也确认了 socilalite 代码所提供的方法不能解析出用户,不知道为何同样是 oauth2,为何 google 对于 android 和 web 提供的方法不一致。

此处需要使用到 google 的 PHP sdk:composer require google/apiclient:"^2.0"

$client_id = config('service.google.client_id');

$client = new Google_Client(['client_id' => $client_id]);

try {
    $payload = $client->verifyIdToken($code);
  
    if ($payload) {
        return $payload;
  } else {
      throw new UnauthorizedHttpException("the token is invalid", 40110);
  }
} catch (\Throwable $exception) {
    throw new UnauthorizedHttpException("error when verify token from google", 40111);
}

四、paypal 登录

socialite 完全不能用,网上的文章也不靠谱。经过反复折腾,看了paypal 无数的 API 文档,SDK 使用说明,没有找到对路的办法,最终参考 paypal connect 官方文档解决,就是一个字,累。

在没有找到 Paypal connect 文档之前,在 paypal 的各种 api 文档中都检索不出头绪来。每次还需要客户端给生成一个 token,想着拿到的应该类似 facebook 或者 google 的 access_token,用 socialite 库直接读出来就好,万万没想到,这货却是一个 auth_code,需要在 server 端到 paypal server 上换一个 access_token,然后才能拿到用户信息。

先是按照官方文档的例子,用 postman 测试了下,确认了 api,最终使用了 PayPal-PHP-SDK,不过这货也是一个坑,官方已经设置为 readonly 了,基本上已经弃用,方法中的 api 接口都是旧的,不过请求的格式没太大变化,因此可以继承一下官方类来换取 access_token 和解析用户数据,等有空了,可以自己实现并维护一个库。

获取 access_token:

public static function getAccessToken($params, $apiContext)
    {
        static $allowedParams = array('grant_type' => 1, 'code' => 1);

        if (!array_key_exists('grant_type', $params)) {
            $params['grant_type'] = 'authorization_code';
        }

        $clientId = $apiContext->getCredential()->getClientId();
        $clientSecret = $apiContext->getCredential()->getClientSecret();

        $json = self::executeCall(
            "/v1/oauth2/token",
            "POST",
            http_build_query(array_intersect_key($params, $allowedParams)),
            array(
                'Content-Type' => 'application/x-www-form-urlencoded',
                'Authorization' => 'Basic ' . base64_encode($clientId . ":" . $clientSecret)
            ),
            $apiContext
        );

        $data = json_decode($json);

        return $data->access_token;
    }

获取用户信息:

public static function getUserInfo($params, $apiContext = null)
{
    static $allowedParams = array('schema' => 1);

    $params = is_array($params) ? $params : array();

    if (!array_key_exists('schema', $params)) {
        $params['schema'] = 'paypalv1.1';
    }

    $requestUrl = "/v1/identity/oauth2/userinfo?"
        . http_build_query(array_intersect_key($params, $allowedParams));

    $json = self::executeCall(
        $requestUrl,
        "GET",
        "",
        array(
            'Authorization' => "Bearer " . $params['access_token'],
            'Content-Type' => 'x-www-form-urlencoded'
        ),
        $apiContext
    );

    $ret = new UserInfo();

    $ret->fromJson($json);

    return $ret;
}

顺便,参考官方文档,写了个简单的页面,并在页面上放置一个跳转按钮,自己获取 auth_code, 这样再也不用依赖客户端的同事给生 code 了,大大简化了开发和测试流程。

五、结尾

小小的功能,写了两天,我也是醉了,究其原因有如下三点:

第一,是思想中过于依赖 socialite 库,以为这货考虑了 android 这样的客户端请求的情形,结果浪费了不少测试的事件。

第二,不得不吐槽 paypal 的官方文档了,可能因为 paypal 主要是做支付的,在 developer.paypal.com 中检索内容,很难检索到相关内容,最终还是产品的同事给了个链接