1 | <?php |
||
11 | trait HasBookings |
||
12 | { |
||
13 | use BookingScopes; |
||
14 | |||
15 | /** |
||
16 | * Define a polymorphic one-to-many relationship. |
||
17 | * |
||
18 | * @param string $related |
||
19 | * @param string $name |
||
20 | * @param string $type |
||
|
|||
21 | * @param string $id |
||
22 | * @param string $localKey |
||
23 | * |
||
24 | * @return \Illuminate\Database\Eloquent\Relations\MorphMany |
||
25 | */ |
||
26 | abstract public function morphMany($related, $name, $type = null, $id = null, $localKey = null); |
||
27 | |||
28 | /** |
||
29 | * Get the booking model name. |
||
30 | * |
||
31 | * @return string |
||
32 | */ |
||
33 | abstract public static function getBookingModel(): string; |
||
34 | |||
35 | /** |
||
36 | * Boot the HasBookings trait for the model. |
||
37 | * |
||
38 | * @return void |
||
39 | */ |
||
40 | public static function bootHasBookings() |
||
46 | |||
47 | /** |
||
48 | * The customer may have many bookings. |
||
49 | * |
||
50 | * @return \Illuminate\Database\Eloquent\Relations\MorphMany |
||
51 | */ |
||
52 | public function bookings(): MorphMany |
||
56 | |||
57 | /** |
||
58 | * Get bookings of the given resource. |
||
59 | * |
||
60 | * @param \Illuminate\Database\Eloquent\Model $bookable |
||
61 | * |
||
62 | * @return \Illuminate\Database\Eloquent\Relations\MorphMany |
||
63 | */ |
||
64 | public function bookingsOf(Model $bookable): MorphMany |
||
68 | |||
69 | /** |
||
70 | * Check if the person booked the given model. |
||
71 | * |
||
72 | * @param \Illuminate\Database\Eloquent\Model $bookable |
||
73 | * |
||
74 | * @return bool |
||
75 | */ |
||
76 | public function isBooked(Model $bookable): bool |
||
80 | |||
81 | /** |
||
82 | * Book the given model at the given dates with the given price. |
||
83 | * |
||
84 | * @param \Illuminate\Database\Eloquent\Model $bookable |
||
85 | * @param string $startsAt |
||
86 | * @param string $endsAt |
||
87 | * |
||
88 | * @return \Rinvex\Bookings\Models\BookableBooking |
||
89 | */ |
||
90 | public function newBooking(Model $bookable, string $startsAt, string $endsAt): BookableBooking |
||
101 | } |
||
102 |
This check looks for
@param
annotations where the type inferred by our type inference engine differs from the declared type.It makes a suggestion as to what type it considers more descriptive.
Most often this is a case of a parameter that can be null in addition to its declared types.