Getting Started

Minimal Steps for Laravel Adoption

Abandon Direct Use: This bundle is not Laravel-compatible. Instead, use these alternatives:
- For a quick blog: Install Laravel Nova (if on Laravel 8+) or October CMS.
- For custom development: Scaffold a blog with:
```
composer require laravel/nova laravel/breeze --dev
php artisan nova:install
php artisan breeze:install blog
```

First Use Case (Laravel Alternative): Create a post model and migration:

php artisan make:model Post -m

Define migration (database/migrations/..._create_posts_table.php):

Schema::create('posts', function (Blueprint $table) {
    $table->id();
    $table->string('title');
    $table->text('content');
    $table->string('slug')->unique();
    $table->foreignId('user_id')->constrained();
    $table->timestamps();
});

Run migration:

php artisan migrate

Create a controller:

php artisan make:controller PostController --resource

Add routes (routes/web.php):

Route::resource('posts', PostController::class);

Where to Look First:
- Laravel Docs: Eloquent ORM, Controllers.
- Packages:
  - Spatie Media Library (for file uploads).
  - Laravel Scout (for search).
- UI: Use Livewire or Inertia.js for dynamic forms.

Implementation Patterns

Laravel-Centric Workflows

Model-View-Controller (MVC) Pattern:

Model: Define Post with relationships (e.g., belongsTo(User)).

// app/Models/Post.php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
class Post extends Model {
    public function user() { return $this->belongsTo(User::class); }
}

Controller: Use resource controllers for CRUD.

// app/Http/Controllers/PostController.php
public function index() {
    return view('posts.index', ['posts' => Post::latest()->paginate(10)]);
}

View: Blade templates for rendering.

<!-- resources/views/posts/index.blade.php -->
@foreach($posts as $post)
    <article>
        <h2>{{ $post->title }}</h2>
        <p>{{ Str::limit($post->content, 200) }}</p>
    </article>
@endforeach

File Uploads (Replacing VichUploader):

Install Spatie Media Library:

composer require spatie/laravel-medialibrary
php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider"

Add to Post model:

use Spatie\MediaLibrary\HasMedia;
use Spatie\MediaLibrary\InteractsWithMedia;
class Post extends Model implements HasMedia {
    use InteractsWithMedia;
}

Upload logic in controller:

public function store(Request $request) {
    $post = Post::create($request->validate([
        'title' => 'required',
        'content' => 'required',
        'image' => 'nullable|image'
    ]));
    if ($request->hasFile('image')) {
        $post->addMediaFromRequest('image')->toMediaCollection('images');
    }
    return redirect()->route('posts.show', $post);
}

Pagination (Replacing KnpPaginator):

Laravel’s built-in pagination:

$posts = Post::latest()->paginate(10); // Returns a LengthAwarePaginator

Customize views:

{{ $posts->links() }} <!-- Default pagination links -->

Tailor pagination:

$posts = Post::latest()->paginate(10, ['*'], 'custom');

CLI Commands (Replacing Bundle Commands):

Create a custom command:
```
php artisan make:command CreatePost
```

Define logic:

// app/Console/Commands/CreatePost.php
public function handle() {
    $post = Post::create([
        'title' => $this->ask('Title'),
        'content' => $this->ask('Content'),
        'slug' => Str::slug($this->ask('Slug')),
        'user_id' => auth()->id()
    ]);
    $this->info("Post created: {$post->slug}");
}

protected $commands = [
    \App\Console\Commands\CreatePost::class,
];

Run:
```
php artisan create:post
```

User Integration:

Use Laravel’s built-in User model or extend it:

// app/Models/User.php
public function posts() { return $this->hasMany(Post::class); }

Authenticate via Laravel’s auth() helper or middleware:

Route::middleware(['auth'])->group(function () {
    Route::resource('posts', PostController::class);
});

Service Providers (Replacing Symfony Services):

public function register() {
    $this->app->singleton('postRepository', function () {
        return new \App\Repositories\PostRepository;
    });
}

Bind interfaces to implementations:

$this->app->bind(
    \App\Contracts\PostRepository::class,
    \App\Repositories\EloquentPostRepository::class
);

Events (Replacing Symfony Events):

Define events:
```
php artisan make:event PostCreated
```

Listen to events:

// app/Providers/EventServiceProvider.php
protected $listen = [
    \App\Events\PostCreated::class => [
        \App\Listeners\NotifyPostAuthor::class,
    ],
];

Dispatch events:
```
event(new PostCreated($post));
```

Gotchas and Tips

Pitfalls

Symfony-Specific Assumptions:

Doctrine Annotations: The bundle uses @ORM\*, which Laravel’s Eloquent does not support. Replace with Eloquent attributes (PHP 8+) or fluent methods:

// Symfony (Doctrine)
/** @ORM\ManyToOne(targetEntity="User") */
private $user;

// Laravel (Eloquent)
public function user() { return $this->belongsTo(User::class); }

Twig Syntax: Avoid {% extends %} or {{ asset() }} in templates. Use Blade:

@extends('layouts.app')
@section('content')
    <img src="{{ asset('storage/' . $post->image) }}">
@endsection

Database Schema Mismatches:
- The bundle assumes User extends Symfony’s User class. In Laravel, use:
```
// app/Models/User.php
use Illuminate\Foundation\Auth\User as Authenticatable;
class User extends Authenticatable { ... }
```
- Foreign keys may need adjustment (e.g., user_id vs. author_id).
Routing Conflicts:
- Symfony routes use YAML/annotations. Laravel uses:
```
Route::get('/posts/{post:slug}', [PostController::class, 'show']);
```
- Avoid route caching conflicts by using explicit route names:
```
Route::name('posts.show')->get('/posts/{post}', ...);
```
Dependency Injection:
- Symfony uses ContainerAware or autowiring via annotations. Laravel uses:
```
public function __construct(private PostRepository $posts) {}
```
- Avoid new instantiations; use dependency injection.
File Upload Paths:
- VichUploader uses vich_uploader.destination. In Laravel, configure spatie/laravel-medialibrary in .env:
```
MEDIA_LIBRARY_DISK=public
```
- Ensure public/storage is symlinked:
```
php artisan storage:link
```
Pagination Quirks:
- KnpPaginator uses Knp\Component\Pager\PaginatorInterface. Laravel

Blog Bundle Laravel Package