/**
* Save a new model and attach it to the parent model.
*
* @param \Illuminate\Database\Eloquent\Model $model
* @param array $joining
* @param bool $touch
* @return \Illuminate\Database\Eloquent\Model
*/
public function save(Model $model, array $joining = [], $touch = true)
//public function save (Model $model,array $joining = [],$touch = true)
{//save a new model and attach it to the parent model
$model->save([‘touch‘ => false]);// a fixed function use type
$this->attach($model->getKey(), $joining, $touch);// attach has three parameters
// first getKey second joining third is touch
return $model;
}// return self by class name
/**
* Save an array of new models and attach them to the parent model.
*
* @param \Illuminate\Support\Collection|array $models
* @param array $joinings
* @return array
*/
public function saveMany($models, array $joinings = [])
{//save an array of new models and attach them to the parent model.
foreach ($models as $key => $model) {
$this->save($model, (array) Arr::get($joinings, $key), false);
}//loop models , wrap a function that name is saveMany,
$this->touchIfTouching();// use a default process.
return $models;
}// return this models
/**
* Find a related model by its primary key.
*
* @param mixed $id
* @param array $columns
* @return \Illuminate\Database\Eloquent\Model|\Illuminate\Database\Eloquent\Collection|null
*/
public function find($id, $columns = [‘*‘])
{// Find a related model by its primary key.
if (is_array($id)) {
return $this->findMany($id, $columns);// findMany
}// if this target is a array ,we will use a function to wrap it.
$this->where($this->getRelated()->getQualifiedKeyName(), ‘=‘, $id);//default just do it
return $this->first($columns);
}// return this fist result with this options
/**
* Find multiple related models by their primary keys.
*
* @param mixed $ids
* @param array $columns
* @return \Illuminate\Database\Eloquent\Collection
*/
public function findMany($ids, $columns = [‘*‘])
{// Find multiple related models by their primary keys.
if (empty($ids)) {
return $this->getRelated()->newCollection();
}// if this ids is null or empty we just return a new Collection
$this->whereIn($this->getRelated()->getQualifiedKeyName(), $ids);// get More ids
return $this->get($columns);
}// return this get Columns
/**
* Find a related model by its primary key or throw an exception.
*
* @param mixed $id
* @param array $columns
* @return \Illuminate\Database\Eloquent\Model|\Illuminate\Database\Eloquent\Collection
*
* @throws \Illuminate\Database\Eloquent\ModelNotFoundException
*/
public function findOrFail($id, $columns = [‘*‘])
{//Find a related model by its primary key or throw an exception
$result = $this->find($id, $columns);// this is the find result by option with id and columns
if (is_array($id)) {// if this id is a aggregate
if (count($result) == count(array_unique($id))) {
return $result;// check this result , ok just return it
}
} elseif (! is_null($result)) {// null return it self
return $result;
}
// default throw something wrong.
throw (new ModelNotFoundException)->setModel(get_class($this->parent));
}
/**
* Find a related model by its primary key or return new instance of the related model.
*
* @param mixed $id
* @param array $columns
* @return \Illuminate\Support\Collection|\Illuminate\Database\Eloquent\Model
*/
public function findOrNew($id, $columns = [‘*‘])
{//Find or new
//Find a related model by its primary key or return new instance of the related model.
if (is_null($instance = $this->find($id, $columns))) {
$instance = $this->getRelated()->newInstance();
}//whatever we must get this instance
return $instance;
}// in the end ,return instance ok
/**
* Get the first related model record matching the attributes or instantiate it.
*
* @param array $attributes
* @return \Illuminate\Database\Eloquent\Model
*/
public function firstOrNew(array $attributes)
{//Get the first related model record matching the attributes or instantiate it.
if (is_null($instance = $this->where($attributes)->first())) {
$instance = $this->related->newInstance($attributes);
}// is null do other
return $instance;// return this instance
}
/**
* Get the first related record matching the attributes or create it.
*
* @param array $attributes
* @param array $joining
* @param bool $touch
* @return \Illuminate\Database\Eloquent\Model
*/
public function firstOrCreate(array $attributes, array $joining = [], $touch = true)
{//Get the first related record matching the attributes or create it.
if (is_null($instance = $this->where($attributes)->first())) {
$instance = $this->create($attributes, $joining, $touch);
}// null
return $instance;
}//return instance
/**
* Create or update a related record matching the attributes, and fill it with values.
*
* @param array $attributes
* @param array $values
* @param array $joining
* @param bool $touch
* @return \Illuminate\Database\Eloquent\Model
*/
public function updateOrCreate(array $attributes, array $values = [], array $joining = [], $touch = true)
{//Create or update a related record matching the attributes, and fill it with values.
if (is_null($instance = $this->where($attributes)->first())) {
return $this->create($values, $joining, $touch);
}// is_null
$instance->fill($values);//fill something
$instance->save([‘touch‘ => false]);// a save function
return $instance;
}// return this instance.
/**
* Create a new instance of the related model.
*
* @param array $attributes
* @param array $joining
* @param bool $touch
* @return \Illuminate\Database\Eloquent\Model
*/
public function create(array $attributes, array $joining = [], $touch = true)
{//Create a new instance of the related model
$instance = $this->related->newInstance($attributes);// first set the instance.
// Once we save the related model, we need to attach it to the base model via
// through intermediate table so we‘ll use the existing "attach" method to
// accomplish this which will insert the record and any more attributes.
$instance->save([‘touch‘ => false]);
$this->attach($instance->getKey(), $joining, $touch);
return $instance;
}// attach to create something
/**
* Create an array of new instances of the related models.
*
* @param array $records
* @param array $joinings
* @return array
*/
public function createMany(array $records, array $joinings = [])
{// this function is creates function,yeah
$instances = [];
foreach ($records as $key => $record) {
$instances[] = $this->create($record, (array) Arr::get($joinings, $key), false);
}
$this->touchIfTouching();
return $instances;
}
/**
* Sync the intermediate tables with a list of IDs or collection of models.
*
* @param \Illuminate\Database\Eloquent\Collection|array $ids
* @param bool $detaching
* @return array
*/
public function sync($ids, $detaching = true)
{//sync to all relation table by ids or models
$changes = [
‘attached‘ => [], ‘detached‘ => [], ‘updated‘ => [],
];// set this changes models
if ($ids instanceof Collection) {
$ids = $ids->modelKeys();
}// ids instanceof Collection
// First we need to attach any of the associated models that are not currently
// in this joining table. We‘ll spin through the given IDs, checking to see
// if they exist in the array of current ones, and if not we will insert.
$current = $this->newPivotQuery()->pluck($this->otherKey);// first get the current
$records = $this->formatSyncList($ids);// get records
$detach = array_diff($current, array_keys($records));// get detach
// Next, we will take the differences of the currents and given IDs and detach
// all of the entities that exist in the "current" array but are not in the
// the array of the IDs given to the method which will complete the sync.
if ($detaching && count($detach) > 0) {
$this->detach($detach);
$changes[‘detached‘] = (array) array_map(function ($v) {
return is_numeric($v) ? (int) $v : (string) $v;
}, $detach);
}
// Now we are finally ready to attach the new records. Note that we‘ll disable
// touching until after the entire operation is complete so we don‘t fire a
// ton of touch operations until we are totally done syncing the records.
$changes = array_merge(
$changes, $this->attachNew($records, $current, false)
);
if (count($changes[‘attached‘]) || count($changes[‘updated‘])) {
$this->touchIfTouching();
}
return $changes;
}
时间： 2024-08-17 23:55:51