承接 ijin82/flysystem-azure 相关项目开发

从需求分析到上线部署,全程专人跟进,保证项目质量与交付效率

邮箱:yvsm@zunyunkeji.com | QQ:316430983 | 微信:yvsm316

ijin82/flysystem-azure

Composer 安装命令:

composer require ijin82/flysystem-azure

包简介

Laravel 10+ adapter for Windows Azure (Fork/Hack of league/flysystem-azure)

README 文档

README

Software License Total Downloads

WARNING! 1.0.7.1 is the last version for Laravel 5+ and PHP7

Azure Blob custom filesystem for Laravel 10+ and PHP8

This solution is mostly hack around thephpleague/flysystem-azure-blob-storage and requires 3+ version.
Tested with Laravel 10, probably supported Laravel 8 & 9, additional tests needed.
Check your solutions carefully before release.

Why forked?

Needed to integrate with L5+ out of the box, and url method for Storage interface.

How to install in Laravel application

Install package

composer require ijin82/flysystem-azure

Open config/app.php and add this to providers section

Ijin82\Flysystem\Azure\AzureBlobServiceProvider::class,

Open config/filesystems.php and add this stuff to disks section

'my_azure_disk1' => [
    'driver' => 'azure_blob',
    'endpoint' => env('AZURE_BLOB_STORAGE_ENDPOINT'),
    'container' => env('AZURE_BLOB_STORAGE_CONTAINER1'),
    'blob_service_url' => env('AZURE_BLOB_SERVICE_URL'),
],

Open your .env and add variables for your disk

AZURE_BLOB_SERVICE_URL={your-blob-service-url}
AZURE_BLOB_STORAGE_ENDPOINT="DefaultEndpointsProtocol=https;AccountName={your-account-name};AccountKey={your-account-key};"
AZURE_BLOB_STORAGE_CONTAINER1={your-container-name}
  1. You can get AZURE_BLOB_SERVICE_URL variable from Properties section of your Storage account settings. That is an url named PRIMARY BLOB SERVICE ENDPOINT or SECONDARY BLOB SERVICE ENDPOINT.
    Same time that could be Azure CDN address (related to your endpoint) to use it as public address for files URL generation.
  2. You can get AZURE_BLOB_STORAGE_ENDPOINT variable from Access keys section of your Storage account settings. That is named CONNECTION STRING
  3. AZURE_BLOB_STORAGE_CONTAINER1 is the name of your pre-created container, that you can add at Overview section of your Storage account settings.

Storage methods supported

REM Path related to container, you need file prefix only if you need subfolder inside container

# Upload example
Storage::disk('disk1')->put('file-folder/file1.png',   
  file_get_contents('/my/file/path/file1.png'),  
  [  
    'mimetype' => 'image/png',  
  ]  
);  
# Get file URL example
$publicUrl = Storage::disk('disk1')->url('file-folder/file1.png');
# Check file exists example
$exists1 = Storage::disk('disk1')->exists('file-folder/file1.png');
# Get file contents example
$contents = Storage::disk('disk1')->get('file-folder/file1.png');
# Delete file example
Storage::disk('disk1')->delete('file-folder/file1.png');
# Delete directory example
# Warning, recursive folder deletion!
Storage::disk('disk1')->deleteDir('file-folder');
# Put uploaded file to storage example
# $file could be file path on disk (string) OR type of File|UploadedFile 
Storage::disk('disk1')->putFileAs('file-folder', $file, 'file1.png'); 

How to upload file

public function someUploadFuncName(Request $request)
{
    $file = $request->file('file_name_from_request');  
    
    // .. file name logic
    // .. file folder logic
    
    $file->storeAs($fileFolder, $fileName, [
        'disk' => 'my_azure_disk1'
    ]);  
    
    // save file name logic
    // to create file URL by name later
    // maybe you want to save file name and folder separated
    $fileNameToSave = $folderName . '/' . $diskFileName;
    
    // .. save file name to DB or etc.
}

How to get file URL

We got file name for selected disk (folder related if folder exists)

echo Storage::disk('my_azure_disk1')->url($fileName);

That is also working in blade templates like this

<a href="{{ Storage::disk('my_azure_disk1')->url($fileName) }}"
    target="_blank">{{ $fileName }}</a>

How to delete file

public function someDeleteFuncName($id)
{
    $file = SomeFileModel::findOrFail($id);
    Storage::disk('my_azure_disk1')->delete($file->name);
    $file->delete();

    // go back or etc..
}

Mimetypes (this can be useful)

Sometimes you need to set up mime types manually (for CDN maybe) to get back correct mime type values. You can do that like this (couple types forced for example):

$fileConents = Storage::disk('public_or_another_local_disk')->get($file);

$forcedMimes = [
    'js' => 'application/javascript',
    'json' => 'application/json',
];

$fileExt = \File::extension($file);

if (array_key_exists($fileExt, $forcedMimes)) {
    $fileMime = $forcedMimes[$fileExt];
} else {
    $fileMime = mime_content_type(Storage::disk('public_or_another_local_disk')->path($file));
}

Storage::disk('my_custom_azure_disk')->put($fileName, $fileConents, [
    'mimetype' => $fileMime,
]);

You can use wget to get response with headers including Content-Type

wget -S https://your-file-host.com/file-name.jpg

Additions

  1. Original repo is here
  2. How to use blob storage from PHP
  3. Feel free to send pull requests and issues.

ijin82/flysystem-azure 适用场景与选型建议

ijin82/flysystem-azure 是一款 基于 PHP 开发的 Composer 扩展包,目前已累计 66.83k 次下载、GitHub Stars 达 16, 最近一次更新时间为 2017 年 08 月 18 日, 在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 ijin82/flysystem-azure 或与其功能相近的方案,如果你在选型或落地过程中遇到问题,例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查,欢迎联系我们协助评估。

围绕 ijin82/flysystem-azure 我们能提供哪些服务?
定制开发 / 二次开发

基于 ijin82/flysystem-azure 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复;针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维;也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ:316430983 微信:yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

统计信息

  • 总下载量: 66.83k
  • 月度下载量: 0
  • 日度下载量: 0
  • 收藏数: 16
  • 点击次数: 19
  • 依赖项目数: 0
  • 推荐数: 0

GitHub 信息

  • Stars: 16
  • Watchers: 1
  • Forks: 40
  • 开发语言: PHP

其他信息

  • 授权协议: MIT
  • 更新时间: 2017-08-18