Consistent chainable mutator behavior (#295)

Author: tw99

src/Aggregation/AbstractAggregation.php

@@ -58,10 +58,14 @@ public function __construct($name)
 
     /**
      * @param string $field
+     *
+     * @return $this
      */
     public function setField($field)
     {
         $this->field = $field;
+
+        return $this;
     }
 
     /**

src/Aggregation/Bucketing/ChildrenAggregation.php

@@ -50,13 +50,15 @@ public function __construct($name, $children = null)
     }
 
     /**
-     * Sets children.
-     *
      * @param string $children
+     *
+     * @return $this
      */
     public function setChildren($children)
     {
         $this->children = $children;
+
+        return $this;
     }
 
     /**

src/Aggregation/Bucketing/CompositeAggregation.php

@@ -103,11 +103,13 @@ public function getType()
      *
      * @param int $size Size
      *
-     * @return void
+     * @return $this
      */
     public function setSize($size)
     {
         $this->size = $size;
+
+        return $this;
     }
 
     /**
@@ -125,11 +127,13 @@ public function getSize()
      *
      * @param array $after After
      *
-     * @return void
+     * @return $this
      */
     public function setAfter(array $after)
     {
         $this->after = $after;
+
+        return $this;
     }
 
     /**

src/Aggregation/Bucketing/DateHistogramAggregation.php

@@ -59,18 +59,26 @@ public function getInterval()
 
     /**
      * @param string $interval
+     *
+     * @return $this
      */
     public function setInterval($interval)
     {
         $this->interval = $interval;
+
+        return $this;
     }
 
     /**
      * @param string $format
+     *
+     * @return $this
      */
     public function setFormat($format)
     {
         $this->format = $format;
+
+        return $this;
     }
 
     /**

src/Aggregation/Bucketing/DateRangeAggregation.php

@@ -58,10 +58,14 @@ public function __construct($name, $field = null, $format = null, array $ranges
 
     /**
      * @param string $format
+     *
+     * @return $this
      */
     public function setFormat($format)
     {
         $this->format = $format;
+
+        return $this;
     }
 
     /**

src/Aggregation/Bucketing/DiversifiedSamplerAggregation.php

@@ -54,10 +54,14 @@ public function getShardSize()
 
     /**
      * @param mixed $shardSize
+     *
+     * @return $this
      */
     public function setShardSize($shardSize)
     {
         $this->shardSize = $shardSize;
+
+        return $this;
     }
 
     /**

src/Aggregation/Bucketing/FilterAggregation.php

@@ -45,13 +45,15 @@ public function __construct($name, BuilderInterface $filter = null)
     }
 
     /**
-     * Sets a filter.
-     *
      * @param BuilderInterface $filter
+     *
+     * @return $this
      */
     public function setFilter(BuilderInterface $filter)
     {
         $this->filter = $filter;
+
+        return $this;
     }
 
     /**

src/Aggregation/Bucketing/FiltersAggregation.php

@@ -58,7 +58,7 @@ public function __construct($name, $filters = [], $anonymous = false)
     /**
      * @param bool $anonymous
      *
-     * @return FiltersAggregation
+     * @return $this
      */
     public function setAnonymous($anonymous)
     {

src/Aggregation/Bucketing/GeoDistanceAggregation.php

@@ -78,10 +78,14 @@ public function getOrigin()
 
     /**
      * @param mixed $origin
+     *
+     * @return $this
      */
     public function setOrigin($origin)
     {
         $this->origin = $origin;
+
+        return $this;
     }
 
     /**
@@ -94,10 +98,14 @@ public function getDistanceType()
 
     /**
      * @param string $distanceType
+     *
+     * @return $this
      */
     public function setDistanceType($distanceType)
     {
         $this->distanceType = $distanceType;
+
+        return $this;
     }
 
     /**
@@ -110,10 +118,14 @@ public function getUnit()
 
     /**
      * @param string $unit
+     *
+     * @return $this
      */
     public function setUnit($unit)
     {
         $this->unit = $unit;
+
+        return $this;
     }
 
     /**

src/Aggregation/Bucketing/GeoHashGridAggregation.php

@@ -67,10 +67,14 @@ public function getPrecision()
 
     /**
      * @param int $precision
+     *
+     * @return $this
      */
     public function setPrecision($precision)
     {
         $this->precision = $precision;
+
+        return $this;
     }
 
     /**
@@ -83,10 +87,14 @@ public function getSize()
 
     /**
      * @param int $size
+     *
+     * @return $this
      */
     public function setSize($size)
     {
         $this->size = $size;
+
+        return $this;
     }
 
     /**
@@ -99,10 +107,14 @@ public function getShardSize()
 
     /**
      * @param int $shardSize
+     *
+     * @return $this
      */
     public function setShardSize($shardSize)
     {
         $this->shardSize = $shardSize;
+
+        return $this;
     }
 
     /**