Laravel Salesforce Integration Development

Development environment configuration for building Laravel packages that integrate with Salesforce APIs through REST clients.

What This Skill Does

Configures Cursor to provide optimal IDE support for Laravel-based Salesforce integration development, including API clients, authentication flows, data synchronization, and enterprise CRM connectivity patterns.

Instructions

File Pattern Recognition

Monitor and provide enhanced support for these Laravel file types:

Language Server Features

Enable full PHP language server capabilities:

Ignored Paths

Exclude these directories from indexing and search for performance:

Development Patterns

When working on Salesforce integrations:

1. **API Client Structure**: Organize REST client methods by Salesforce objects (Account, Contact, Lead, Opportunity)

2. **Authentication**: Implement OAuth 2.0 flows with token refresh handling

3. **Error Handling**: Wrap Salesforce API calls with try-catch for rate limits and connection failures

4. **Data Mapping**: Create clear mappings between Laravel Eloquent models and Salesforce objects

5. **Configuration**: Store Salesforce credentials and endpoints in `config/salesforce.php`

6. **Testing**: Mock Salesforce API responses in tests using Laravel HTTP fakes

7. **Queueing**: Use Laravel queues for bulk data sync operations to avoid timeouts

Package Architecture

Structure your Laravel Salesforce package:

```

src/

├── SalesforceServiceProvider.php

├── Client/

│ ├── SalesforceClient.php

│ └── Authentication/

├── Models/

│ └── SalesforceObject.php

├── Services/

│ └── SyncService.php

└── Exceptions/

└── SalesforceException.php

```

Configuration Example

Ensure `config/salesforce.php` includes:

Usage Examples

**Creating a Salesforce Account:**

```php

$client->create('Account', [

'Name' => 'Acme Corp',

'Industry' => 'Technology'

]);

```

**Querying Contacts:**

```php

$client->query("SELECT Id, Name, Email FROM Contact WHERE AccountId = '{$accountId}'");

```

**Handling Authentication:**

```php

$token = $authenticator->getAccessToken();

$client->setToken($token);

```

Important Notes