تعتبر Multer وسيط node.js لمعالجة `multipart/form-data`, والتي تُستخدم أساسًا لتحميل الملفات. تم بناء هذا الوسيط بالإعتماد على [busboy](https://github.com/mscdex/busboy) لأجل الحصول على أقصى قدر من الكفاءة.
**ملاحظة**: لن يقوم Multer بمعالجة أي شكل غير متعدد الأجزاء (`multipart/form-data`).
## الترجمات
هذا الملف متاح أيضًا بلغات أخرى:
- [English](https://github.com/expressjs/multer/blob/main/README.md) (الإنجليزية)
- [Español](https://github.com/expressjs/multer/blob/main/doc/README-es.md) (الإسبانية)
- [简体中文](https://github.com/expressjs/multer/blob/main/doc/README-zh-cn.md) (الصينية)
- [한국어](https://github.com/expressjs/multer/blob/main/doc/README-ko.md) (الكورية)
- [Русский язык](https://github.com/expressjs/multer/blob/main/doc/README-ru.md) (الروسية)
- [Việt Nam](https://github.com/expressjs/multer/blob/main/doc/README-vi.md) (الفتنامية)
- [Português](https://github.com/expressjs/multer/blob/main/doc/README-pt-br.md) (البرتغالية)
## التنصيب
```sh
$ npm install --save multer
```
## الاستعمال
يضيف Multer كائن `body` وكائن `file` أو `files` إلى كائن `request`. يحتوي الكائن `body` على قيم مدخلات النص في الإستمارة ، بينما يحتوي الكائن `file` أو `files` على الملفات التي تم تحميلها عبر الإستمارة.
مثال على الاستخدام الأساسي:
لا تنسَ
`enctype="multipart/form-data"` في الإستمارة الخاص بك.
```html
```
```javascript
var express = require('express')
var multer = require('multer')
var upload = multer({ dest: 'uploads/' })
var app = express()
app.post('/profile', upload.single('avatar'), function (req, res, next) {
// req.file is the `avatar` file
// req.body will hold the text fields, if there were any
})
app.post('/photos/upload', upload.array('photos', 12), function (req, res, next) {
// req.files is array of `photos` files
// req.body will contain the text fields, if there were any
})
var uploadMiddleware = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
app.post('/cool-profile', uploadMiddleware, function (req, res, next) {
// req.files is an object (String -> Array) where fieldname is the key, and the value is array of files
//
// e.g.
// req.files['avatar'][0] -> File
// req.files['gallery'] -> Array
//
// req.body will contain the text fields, if there were any
})
```
إذا احتجت لمعالجة إستمارة متعددة الأجزاء للنص فقط ، فيجب عليك استخدام الدالة `.none ()`:
```javascript
var express = require('express')
var app = express()
var multer = require('multer')
var upload = multer()
app.post('/profile', upload.none(), function (req, res, next) {
// req.body contains the text fields
})
```
## واجهة برمجة التطبيقات (API)
### معلومات الملف
كل ملف يحتوي على المعلومات التالية:
مفتاح | وصف | ملاحظة
--- | --- | ---
`fieldname` | اسم المُدخَل المحدد في الإستمارة |
`originalname` | اسم الملف على كمبيوتر المستخدم |
`encoding` | نوع تشفير الملف |
`mimetype` | نوع ملف ملحقات بريد إنترنت متعددة الأغراض ( MIME ) |
`size` | حجم الملف بالبايت |
`destination` | المجلد الذي تم حفظ الملف إليه | `تخزين على الاسطوانة` (`DiskStorage`)
`filename` | اسم الملف داخل "الوجهة" ( `destination` ) | `تخزين على الاسطوانة` (`DiskStorage`)
`path` | المسار الكامل للملف الذي تم تحميله | `تخزين على الاسطوانة` (`DiskStorage`)
`buffer` | "ذاكرة" (`Buffer`) للملف بأكمله | `تخزين على الذاكرة ` (`MemoryStorage`)
### `multer(opts)`
يقبل Multer كائن الخيارات ، وأهمها خاصية `dest`، والتي تحدد مكان تحميل الملفات. في حال حذفت كائن الخيارات ، سيتم الاحتفاظ بالملفات في الذاكرة ولن تتم كتابتها مطلقًا على القرص.
بشكل افتراضي ، سيقوم Multer بإعادة تسمية الملفات لتجنب تعارض الأسماء. يمكن تخصيص وظيفة إعادة التسمية وفقا لاحتياجاتك.
فيما يلي الخيارات التي يمكن تمريرها إلى Multer:
مفتاح | وصف
--- | ---
`dest` أو `storage` | مكان لتخزين الملفات
`fileFilter` | دالة للسيطرة على الملفات التي يتم قبولها
`limits` | حدود البيانات التي تم تحميلها
`preservePath` | الاحتفظ بالمسار الكامل للملفات بدلاً من الاسم الأساسي
`defParamCharset` | مجموعة الأحرف الافتراضية لاستخدامها لقيم معاملات رأس الجزء (مثل اسم الملف) التي ليست معاملات موسعة (لا تحتوي على مجموعة أحرف صريحة). الافتراضي: `'latin1'`
في تطبيق ويب متوسط ، قد تكون هناك حاجة فقط إلى `dest`، وتكوينها كما هو موضح في
المثال التالي :
```javascript
var upload = multer({ dest: 'uploads/' })
```
إذا كنت تريد مزيدًا من التحكم في عمليات التحميل ، فستحتاج إلى استخدام خيار `storage` بدلاً من `dest`. يأتي Multer مع محركات التخزين `DiskStorage` و` MemoryStorage` ؛ كما تتوفر المزيد من المحركات من أطراف ثالثة.
#### `.single(fieldname)`
قبول ملف واحد باسم `اسم-المُدخَل`. سيتم تخزين الملف في `req.file`.
#### `.array(fieldname[, maxCount])`
قبول مصفوفة من الملفات ، وكلها تحمل اسم `اسم-المُدخَل`. يظهر خطأ اختياريً إذا تم تحميل ملفات أكثر من `maxCount`. سيتم تخزين مصفوفة الملفات في `req.files`.
#### `.fields(fields)`
قبول مزيج من الملفات ، المحدد بواسطة `المدخلات`. سيتم تخزين كائن مع مصفوفات من الملفات في `req.files`.
يجب أن تكون `المدخلات` عبارة عن مصفوفة من الكائنات التي توفر بشكل اساسي `name` واختيارياً `maxCount`.
مثال:
```javascript
[
{ name: 'avatar', maxCount: 1 },
{ name: 'gallery', maxCount: 8 }
]
```
#### `.none()`
قبول المدخلات النصية فقط. في حالة رفع أي ملف ، سيتم إصدار خطأ بشيفرة "LIMIT \_UNEXPECTED \_FILE".
#### `.any()`
قبول جميع الملفات التي تأتي عبر السلك. سيتم تخزين مصفوفة من الملفات في `req.files`.
**تحذير:** تأكد من أنك تعالج دائمًا الملفات التي يقوم المستخدم بتحميلها. لا تقم أبداً بإضافة multer باعتبارها أداة وسيطة عامة ، حيث يمكن للمستخدم الضار تحميل الملفات إلى مسار غير متتوقع. استخدم هذه الدالة فقط على المسارات التي تتعامل فيها مع الملفات التي تم تحميلها.
### `storage`
#### `DiskStorage`
يمنحك محرك تخزين القرص التحكم الكامل في تخزين الملفات على القرص.
```javascript
var storage = multer.diskStorage({
destination: function (req, file, cb) {
cb(null, '/tmp/my-uploads')
},
filename: function (req, file, cb) {
cb(null, file.fieldname + '-' + Date.now())
}
})
var upload = multer({ storage: storage })
```
هناك خياران متاحان ، `destination` و `filename`. كلاهما يعملان على تحديد مكان تخزين الملف.
يتم استخدام `destination` لتحديد أي مجلد يجب تخزين الملفات المحملة. يمكن أيضًا إعطاء هذا كـ`سلسلة` (مثل `'/tmp/uploads'`). إذا لم يتم إعطاء `destination` ، فسيتم استخدام الدليل الافتراضي لنظام التشغيل للملفات المؤقتة.
**ملاحظة:** أنت مسؤول عن إنشاء الدليل عند توفر `destination` كدالة. عند المرور بسلسلة ، سوف يتأكد multer من إنشاء الدليل من أجلك.
يتم استخدام `اسم الملف` لتحديد ما يجب تسمية الملف داخل المجلد. إذا لم يتم تقديم `اسم الملف`، فسيتم إعطاء كل ملف اسمًا عشوائيًا لا يتضمن أي امتداد للملف.
**ملاحظة:** لن يقوم multer بإلحاق اي ملحق ملف لك، الدالة الخاص بك يجب أن تقوم بإرجاع اسم ملف كامل بملحق الملف.
يتم تمرير كل دالة من خلال الطلب (req`) وبعض المعلومات حول الملف (`file`) للمساعدة في اتخاذ القرار.
لاحظ أن `req.body` ربما لم يتم ملؤها بالكامل بعد. يعتمد ذلك على الترتيب الذي يقوم به العميل من خلال نقل المدخلات والملفات إلى الخادم.
#### `MemoryStorage`
يخزن محرك تخزين الذاكرة الملفات الموجودة في الذاكرة ككائنات `ذاكرة` (`Buffer`). ليس لديها أي خيارات.
```javascript
var storage = multer.memoryStorage()
var upload = multer({ storage: storage })
```
عند استخدام ذاكرة التخزين ، ستحتوي معلومات الملف على مُدخَل يسمى `buffer` الذي يحتوي على الملف بأكمله.
**تحذير**: يمكن أن يؤدي تحميل ملفات كبيرة جدًا أو ملفات صغيرة نسبيًا بأعداد كبيرة و بسرعة كبيرة إلى نفاد ذاكرة التطبيق عند استخدام ذاكرة التخزين.
### `limits`
كائن يحدد حدود حجم الخصائص الاختيارية التالية. يقوم Multer بتمرير هذا الكائن إلى busboy مباشرة ، ويمكن العثور على تفاصيل الخصائص من خلال [صفحة busboy's](https://github.com/mscdex/busboy#busboy-methods).
تتوفر القيم الصحيحة التالية:
مفتاح | وصف | افتراضي
--- | --- | ---
`fieldNameSize` | الحد الأقصى لحجم اسم المُدخَل | 100 بايت
`fieldSize` | الحد الأقصى لحجم قيمة المُدخَل (بالبايت) | 1 ميغابايت
`fields` | الحد الأقصى لعدد المدخلات التى لا تعتبر من الملفات | ما لا نهاية
`fileSize` | حجم الملف الأقصى بالنسبة لإستمارة متعددة الأجزاء (بالبايت) | ما لا نهاية
`files` | الحد الأقصى لعدد المدخلات من نوع الملفات بالنسبة لإستمارة متعددة الأجزاء | ما لا نهاية
`parts` | الحد الأقصى لعدد الأجزاء (مدخلات + ملفات) بالنسبة لإستمارة متعددة الأجزاء | ما لا نهاية
`headerPairs` | الحد الأقصى لعدد أزواج الرأس (المفتاح => القيمة) المطلوب تحليلها بالنسبة لإستمارة متعددة الأجزاء | 2000
يمكن أن يساعد تحديد الحدود في حماية موقعك من هجمات حجب الخدمة (DoS).
### `fileFilter`
اضبط هذا على دالة للتحكم في الملفات التي ينبغي تحميلها وأي الملفات يجب تخطيها. يجب أن تبدو دالة كما يلي:
```javascript
function fileFilter (req, file, cb) {
// The function should call `cb` with a boolean
// to indicate if the file should be accepted
// To reject this file pass `false`, like so:
cb(null, false)
// To accept the file pass `true`, like so:
cb(null, true)
// You can always pass an error if something goes wrong:
cb(new Error('I don\'t have a clue!'))
}
```
## معالجة الأخطاء
عند مواجهة خطأ ، سيقوم Multer بتفويض الخطأ إلى Express. يمكنك
عرض صفحة خطأ لطيفة باستخدام [طريقة Express القياسية](http://expressjs.com/guide/error-handling.html).
إذا كنت تريد إنتقاء الأخطاء والحصول على [أخطاء Multer فقط](https://github.com/expressjs/multer/blob/main/lib/multer-error.js)، فيمكنك نداء بدالة الوسيطة من قبل نفسك. أيضًا ، إذا كنت تريد التقاط أخطاء Multer فقط ، فيمكنك استخدام صنف `MulterError` المتصل بالكائن` multer` نفسه (على سبيل المثال `err instanceof multer.MulterError`).
```javascript
var multer = require('multer')
var upload = multer().single('avatar')
app.post('/profile', function (req, res) {
upload(req, res, function (err) {
if (err instanceof multer.MulterError) {
// A Multer error occurred when uploading.
} else if (err) {
// An unknown error occurred when uploading.
}
// Everything went fine.
})
})
```
## محرك التخزين الخاص بك
للحصول على معلومات حول كيفية إنشاء محرك التخزين الخاص بك ، راجع [محرك تخزين Multer](https://github.com/expressjs/multer/blob/main/StorageEngine.md).
## الترخيص
[MIT](LICENSE)
[ci-image]: https://github.com/expressjs/multer/actions/workflows/ci.yml/badge.svg
[ci-url]: https://github.com/expressjs/multer/actions/workflows/ci.yml
[test-url]: https://coveralls.io/r/expressjs/multer?branch=main
[test-image]: https://badgen.net/coveralls/c/github/expressjs/multer/main
[npm-downloads-image]: https://badgen.net/npm/dm/multer
[npm-url]: https://npmjs.org/package/multer
[npm-version-image]: https://badgen.net/npm/v/multer
[ossf-scorecard-badge]: https://api.scorecard.dev/projects/github.com/expressjs/multer/badge
[ossf-scorecard-visualizer]: https://ossf.github.io/scorecard-visualizer/#/projects/github.com/expressjs/multer
expressjs-multer-2e2af08/doc/README-es.md 0000664 0000000 0000000 00000034112 15213763722 0020121 0 ustar 00root root 0000000 0000000 # Multer [![NPM Version][npm-version-image]][npm-url] [![NPM Downloads][npm-downloads-image]][npm-url] [![Build Status][ci-image]][ci-url] [![Test Coverage][test-image]][test-url] [![OpenSSF Scorecard Badge][ossf-scorecard-badge]][ossf-scorecard-visualizer]
Multer es un "*middleware*" de node.js para el manejo de `multipart/form-data`, el cuál es usado sobre todo para la subida de archivos. Está escrito sobre [busboy](https://github.com/mscdex/busboy) para maximizar su eficiencia.
**NOTA**: Multer no procesará ningún formulario que no sea multiparte (`multipart/form-data`).
## Traducciones
Éste archivo README también está disponible en otros lenguajes:
- [English](https://github.com/expressjs/multer/blob/main/README.md) (Inglés)
- [简体中文](https://github.com/expressjs/multer/blob/main/doc/README-zh-cn.md) (Chino)
- [한국어](https://github.com/expressjs/multer/blob/main/doc/README-ko.md) (Coreano)
- [Русский язык](https://github.com/expressjs/multer/blob/main/doc/README-ru.md) (Ruso)
- [Português](https://github.com/expressjs/multer/blob/main/doc/README-pt-br.md) (Portugués Brasileño)
## Instalación
```sh
$ npm install --save multer
```
## Uso
Multer añade un objeto `body` y un objeto `file` o `files` al objeto `request`. El objeto `body` contiene los valores correspondientes a los campos de texto del formulario, los objetos `file` o `files` contienen los archivos que serán subidos mediante el formulario.
Ejemplo básico de cómo usarlo:
No te olvides de `enctype="multipart/form-data"` en tu formulario.
```html
```
```javascript
const express = require('express')
const multer = require('multer')
const upload = multer({ dest: 'uploads/' })
const app = express()
app.post('/profile', upload.single('avatar'), function (req, res, next) {
// req.file es el archivo del `avatar`
// req.body contendrá los campos de texto, si los hubiera.
})
app.post('/photos/upload', upload.array('photos', 12), function (req, res, next) {
// req.files es el arreglo (array) de archivos `photos`
// req.body contendrá los campos de texto, si los hubiera.
})
const uploadMiddleware = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
app.post('/cool-profile', uploadMiddleware, function (req, res, next) {
// req.files es un objeto (String -> Array) donde el nombre del campo es la clave (key) y el valor es el arreglo (array) de archivos
//
// Ejemplo
// req.files['avatar'][0] -> Archivo
// req.files['gallery'] -> Array
//
// req.body contendrá los campos de texto, si los hubiera.
})
```
En caso de que necesites manejar un formulario multiparte (multipart form) que sólo contiene campos de texto, deberias usar el método `.none()`:
```javascript
const express = require('express')
const app = express()
const multer = require('multer')
const upload = multer()
app.post('/profile', upload.none(), function (req, res, next) {
// req.body contiene los campos textuales
})
```
Este es un ejemplo de cómo se utiliza multer en un formulario HTML. Presta especial atención en los campos `enctype="multipart/form-data"` y `name="uploaded_file"`:
```html
```
Luego en tu archivo javascript agrega estas líneas para acceder tanto al archivo (file) como al body.Es importante que uses el valor del campo `name` del formulario, en tu función de subida. Esto le indica a multer en qué campo de la petición debe buscar los archivos. Si estos campos no son los mismos en el formulario HTML y en tu servidor, la subida fallará:
```javascript
const multer = require('multer')
const upload = multer({ dest: './public/data/uploads/' })
app.post('/stats', upload.single('uploaded_file'), function (req, res) {
// req.file es el nombre de tu archivo en el formulario anterior, en este caso 'uploaded_file'
// req.body contendrá los campos de texto, si los hubiera.
console.log(req.file, req.body)
});
```
## API
### Información del archivo
Cada archivo contiene la siguiente información:
Clave (Key) | Descripción | Nota
--- | --- | ---
`fieldname` | Nombre del campo especificado en el formulario |
`originalname` | Nombre del archivo en la computadora del usuario |
`encoding` | Tipo de codificación del archivo |
`mimetype` | Mime type del archivo |
`size` | Tamaño del archivo en Bytes |
`destination` | La carpeta donde se guardó el archivo | `DiskStorage`
`filename` | El nombre del archivo en `destination` | `DiskStorage`
`path` | La ruta completa al archivo subido | `DiskStorage`
`buffer` | Un `Buffer` del archivo completo | `MemoryStorage`
### `multer(opts)`
Multer acepta un objeto para configurar sus opciones, la más básica de ellas es la propiedad `dest`, la cual informa a Multer dónde debe subir los archivos. En caso de que omitas el objeto con las opciones, los archivos serán guardados en la memoria y nunca serán escritos en el disco.
Por defecto, Multer renombrará los archivos para evitar conflictos de nombres. La función usada para renombrarlos puede ser modificada acorde a tus necesidades.
Las siguientes son las opciones que pueden ser utilizadas con Multer.
Clave (key) | Descripción
--- | ---
`dest` o `storage` | Donde se guardarán los archivos
`fileFilter` | Función para controlar qué archivos son aceptados
`limits` | Límites de los datos subidos
`preservePath` | Mantiene la ruta completa de la ubicación de los archivos, en vez de sólo sus nombres
`defParamCharset` | Conjunto de caracteres por defecto para usar en valores de parámetros de encabezados de partes (ej. nombre de archivo) que no son parámetros extendidos (que contienen un conjunto de caracteres explícito). Por defecto: `'latin1'`
En la aplicación web promedio es probable que sólo se requiera `dest`, siendo configurado como en el siguiente ejemplo:
```javascript
const upload = multer({ dest: 'uploads/' })
```
Si quieres más control sobre tus subidas, tendrás que usar la opción `storage` en vez de `dest`. Multer incorpora los mecanismos de almacenamiento `DiskStorage` y `MemoryStorage`; existen otros medios provistos por terceros.
#### `.single(fieldname)`
Acepta un único archivo con el nombre `fieldname`. Dicho archivo será guardado en `req.file`.
#### `.array(fieldname[, maxCount])`
Acepta un arreglo (array), de archivos, todos con el nombre `fieldname`. Opcionalmente puede generarse un error si se intentan subir una cantidad de archivos superior a `maxCount`. El arreglo (array) de archivos será guardado en `req.files`.
#### `.fields(fields)`
Acepta una mezcla de archivos, especificados por `field`. Un objeto con arreglos (arrays) de archivos será guardado en `req.files`
`fields` debería ser un arreglo (array) de objetos con `name` y opcionalmente `maxCount`.
Ejemplo:
```javascript
[
{ name: 'avatar', maxCount: 1 },
{ name: 'gallery', maxCount: 8 }
]
```
#### `.none()`
Acepta sólo campos de texto. En caso de intentar subir un archivo, se generará un error con el siguiente código
"LIMIT\_UNEXPECTED\_FILE".
#### `.any()`
Acepta todos los archivos que han sido enviados. Un arreglo (array) conteniendo los archivos, será guardado en `req.files`.
**ADVERTENCIA:** Asegúrate de siempre manejar los archivos que los usuarios intenten subir. Nunca uses Multer como una función middleware de manera global dado que, de esta forma, un usuario malicioso podría subir archivos por medio de rutas que no has anticipado. Usa sólo esta función en rutas en las que estás esperando archivos.
### `storage`
#### `DiskStorage`
El motor de almacenamiento en disco te ofrece un control total sobre el almacenamiento de archivos en tu disco.
```javascript
const storage = multer.diskStorage({
destination: function (req, file, cb) {
cb(null, '/tmp/my-uploads')
},
filename: function (req, file, cb) {
cb(null, file.fieldname + '-' + Date.now())
}
})
const upload = multer({ storage: storage })
```
Hay dos opciones disponibles, `destination` y `filename`. Ambas son funciones que determinan dónde debería almacenarse el archivo.
`destination` se utiliza para determinar en qué carpeta se almacenarán los archivos subidos. Tambien se puede proporcionar como un `string` (por ejemplo: `'/tmp/uploads'`). Si no se proporciona `destination`, se utilizara el directorio predeterminado del sistema operativo para archivos temporales.
**Nota:** Al pasar `destination` como una función, tú eres el responsable de crear los directorios donde los archivos serán almacenados. Cuando asignas un `string` a `destination`, Multer se asegurará de que el directorio sea creado en caso de no encontrarlo.
`filename` es usado para determinar cómo debería ser nombrado el archivo dentro de la carpeta. Si `filename` no es provisto, a cada archivo se le asignará un nombre aleatorio que no incluirá ninguna extensión.
**Nota:** Multer no añadirá ningúna extensión de archivos por ti, es tu función la que debería retornar un nombre completo, que incluya también la extensión del archivo.
El objeto petición (`req`) y parte de la información del archivo (`file`) son pasadas a tu función para ayudar con la decisión en la nomenclatura.
Nota que `req.body` puede que no haya sido totalmente poblado todavía. Esto depende del orden en el que el cliente transmita sus campos y archivos hacia el servidor.
Para comprender la convención de llamada utilizada en el callback (necesitas pasar null como primer parametro), consulta en
[Node.js manejo de errores](https://web.archive.org/web/20220417042018/https://www.joyent.com/node-js/production/design/errors)
#### `MemoryStorage`
El motor de almacenamiento en memoria almacena los archivos en memoria como objetos `Buffer`. Para esto no se proveen opciones.
```javascript
const storage = multer.memoryStorage()
const upload = multer({ storage: storage })
```
Al usar el almacenamiento en memoria, la información del archivo contendrá un campo llamado `buffer` que contiene el archivo entero.
**ADVERTENCIA**: Subir archivos grandes, o relativamente pequeños pero en gran cantidad y muy rápido, puede provocar que tu aplicación se quede sin memoria cuando es usado el almacenamiento en memoria.
### `limits`
Un objeto especifica los límites correpondientes a los tamaños de las siguientes propiedades opcionales. Multer pasa este objeto directamente a *busboy*, los detalles de las propiedades pueden encontrarse en [la página de busboy](https://github.com/mscdex/busboy#busboy-methods).
Los siguientes valores en números enteros están disponibles:
Clave (Key) | Descripción | Por defecto
--- | --- | ---
`fieldNameSize` | Tamaño máximo del nombre del campo | 100 bytes
`fieldSize` | Tamaño máximo de los valores para cada campo (en bytes) | 1MB
`fields` | Número máximo de campos que no son archivos | Infinito
`fileSize` | Para formularios multiparte, el tamaño máximo de los archivos (en bytes) | Infinito
`files` | Para los formularios multiparte, el número máximo de campos para archivos | Infinito
`parts` | Para los formularios multiparte, el número máximo de partes (campos + archivos) | Infinito
`headerPairs` | Para los formularios multiparte, el número máximo de cabeceras de pares clave=>valor para analizar | 2000
Especificar los límites puede ayudarte a proteger tu sitio contra ataques de denegación del servicio (DoS).
### `fileFilter`
Asigna ésto a una función para controlar cuáles archivos deben ser subidos y cuáles deben ser omitidos. La función debería verse como ésta:
```javascript
function fileFilter (req, file, cb) {
// La función debe llamar a `cb` usando una variable del tipo boolean
// para indicar si el archivo debería ser aceptado o no
// Para rechazar el archivo es necesario pasar `false`, de la siguiente forma:
cb(null, false)
// Para aceptar el archivo es necesario pasar `true`, de la siguiente forma:
cb(null, true)
// Siempre puedes pasar un error en caso de que algo salga mal:
cb(new Error('No tengo la menor idea!'))
}
```
## Manejo de errores
Al encontrarse con un error, Multer delegará ese error a Express. Puedes mostrar una linda página de error usando [la manera standard de Express](http://expressjs.com/guide/error-handling.html).
Si quieres capturar los errores específicamente desde Multer, puedes llamar la función middleware tú mismo. También, si quieres capturar sólo [los errores de Multer](https://github.com/expressjs/multer/blob/main/lib/multer-error.js), puedes usar la clase `MulterError` que está adherida al mismo objeto `multer` (por ejemplo: `err instanceof multer.MulterError`).
```javascript
const multer = require('multer')
const upload = multer().single('avatar')
app.post('/profile', function (req, res) {
upload(req, res, function (err) {
if (err instanceof multer.MulterError) {
// Un error de Multer ocurrió durante la subida.
} else if (err) {
// Un error desconocido ocurrió durante la subida.
}
// Todo salió bien.
})
})
```
## Mecanismos de almacenamiento personalizados
Para más información acerca de cómo construir tu propio mecanismo de almacenamiento, recomendamos leer [Multer Storage Engine](https://github.com/expressjs/multer/blob/main/StorageEngine.md).
## Licencia
[MIT](LICENSE)
[ci-image]: https://github.com/expressjs/multer/actions/workflows/ci.yml/badge.svg
[ci-url]: https://github.com/expressjs/multer/actions/workflows/ci.yml
[test-url]: https://coveralls.io/r/expressjs/multer?branch=main
[test-image]: https://badgen.net/coveralls/c/github/expressjs/multer/main
[npm-downloads-image]: https://badgen.net/npm/dm/multer
[npm-url]: https://npmjs.org/package/multer
[npm-version-image]: https://badgen.net/npm/v/multer
[ossf-scorecard-badge]: https://api.scorecard.dev/projects/github.com/expressjs/multer/badge
[ossf-scorecard-visualizer]: https://ossf.github.io/scorecard-visualizer/#/projects/github.com/expressjs/multer
expressjs-multer-2e2af08/doc/README-fr.md 0000664 0000000 0000000 00000035246 15213763722 0020132 0 ustar 00root root 0000000 0000000 # Multer [![NPM Version][npm-version-image]][npm-url] [![NPM Downloads][npm-downloads-image]][npm-url] [![Build Status][ci-image]][ci-url] [![Test Coverage][test-image]][test-url] [![OpenSSF Scorecard Badge][ossf-scorecard-badge]][ossf-scorecard-visualizer]
Multer est un middleware node.js pour la gestion des données `multipart/form-data` qui est principalement utilisé pour télécharger des fichiers.
Il est écrit au-dessus de [busboy](https://github.com/mscdex/busboy) pour une efficacité maximale.
**NOTE**: Multer ne traitera aucun formulaire qui ne soit pas un multipart (`multipart/form-data`).
## Translations
This README is also available in other languages:
- [العربية](https://github.com/expressjs/multer/blob/main/doc/README-ar.md) (Arabe)
- [Español](https://github.com/expressjs/multer/blob/main/doc/README-es.md) (Espagnol)
- [简体中文](https://github.com/expressjs/multer/blob/main/doc/README-zh-cn.md) (Chinois)
- [한국어](https://github.com/expressjs/multer/blob/main/doc/README-ko.md) (Coréen)
- [Русский язык](https://github.com/expressjs/multer/blob/main/doc/README-ru.md) (Russe)
- [Việt Nam](https://github.com/expressjs/multer/blob/main/doc/README-vi.md) (Vietnamien)
- [Português](https://github.com/expressjs/multer/blob/main/doc/README-pt-br.md) (Portugais du Brésil)
- [Français](https://github.com/expressjs/multer/blob/main/doc/README-fr.md) (Français)
## Installation
```sh
$ npm install --save multer
```
## Usage
Multer ajoute un objet `body` et un objet `file` ou `files` à l'objet `request`. L'objet `body` contient les valeurs des champs texte du formulaire, l'objet `file` ou `files` contient les fichiers téléchargés via le formulaire.
Exemple d'utilisation de base :
N'oubliez pas le `enctype="multipart/form-data"` dans votre formulaire.
```html
```
```javascript
const express = require('express')
const multer = require('multer')
const upload = multer({ dest: 'uploads/' })
const app = express()
app.post('/profile', upload.single('avatar'), function (req, res, next) {
// req.file est le fichier `avatar`
// req.body contiendra les champs de texte, s'il y en avait
})
app.post('/photos/upload', upload.array('photos', 12), function (req, res, next) {
// req.files est un tableau de fichiers "photos"
// req.body contiendra les champs de texte, s'il y en avait
})
const uploadMiddleware = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
app.post('/cool-profile', uploadMiddleware, function (req, res, next) {
// req.files est un objet (String -> Array) où fieldname est la clé et la valeur est un tableau de fichiers
//
// e.g.
// req.files['avatar'][0] -> Fichier
// req.files['gallery'] -> Tableau
//
// req.body contiendra les champs de texte, s'il y en avait
})
```
Dans le cas où vous auriez besoin de gérer un formulaire en plusieurs parties texte uniquement, vous devez utiliser la méthode `.none()`:
```javascript
const express = require('express')
const app = express()
const multer = require('multer')
const upload = multer()
app.post('/profile', upload.none(), function (req, res, next) {
// req.body contiens les champs de text
})
```
Voici un exemple d'utilisation de multer dans un formulaire HTML. Faites particulièrement attention aux champs `enctype="multipart/form-data"` et `name="uploaded_file"`:
```html
```
Ensuite, dans votre fichier javascript, vous ajouterez ces lignes pour accéder à la fois au fichier et au corps. Il est important que vous utilisiez la valeur du champ `name` du formulaire dans votre fonction de téléchargement. Cela indique à Multer dans quel champ de la requête il doit rechercher les fichiers. Si ces champs ne sont pas les mêmes dans le formulaire HTML et sur votre serveur, votre téléchargement échouera:
```javascript
const multer = require('multer')
const upload = multer({ dest: './public/data/uploads/' })
app.post('/stats', upload.single('uploaded_file'), function (req, res) {
// req.file est le nom de votre fichier dans le formulaire ci-dessus, ici 'uploaded_file'
// req.body contiendra les champs de texte, s'il y en avait
console.log(req.file, req.body)
});
```
## API
### Informations sur les fichiers
Chaque fichier contient les informations suivantes:
Clé | Description | Notes
--- |------------------------------------------------| ---
`fieldname` | Nom du champ spécifié dans le formulaire |
`originalname` | Nom du fichier sur l'ordinateur de l'utilisateur |
`encoding` | Type d'encodage du fichier |
`mimetype` | Type Mime du fichier |
`size` | Taille du fichier en octets |
`destination` | TLe dossier dans lequel le fichier a été enregistré | `DiskStorage`
`filename` | Le nom du fichier dans la `destination` | `DiskStorage`
`path` | Le chemin d'accès complet au fichier téléchargé | `DiskStorage`
`buffer` | Un `Buffer` du fichier entier | `MemoryStorage`
### `multer(opts)`
Multer accepte un objet d'options, dont le plus basique est le `dest`
propriété, qui indique à Multer où télécharger les fichiers. Au cas où vous omettez l'objet
options, les fichiers seront conservés en mémoire et ne seront jamais écrits sur le disque.
Par défaut, Multer renommera les fichiers afin d'éviter les conflits de nommage. Les
la fonction de renommage peut être personnalisée en fonction de vos besoins.
Voici les options qui peuvent être transmises à Multer.
Clé | Description
--- | ---
`dest` ou `storage` | Où stocker les fichiers
`fileFilter` | Fonction pour contrôler quels fichiers sont acceptés
`limits` | Limites des données téléchargées
`preservePath` | Conservez le chemin complet des fichiers au lieu du nom de base uniquement
`defParamCharset` | Jeu de caractères par défaut à utiliser pour les valeurs des paramètres d'en-tête de partie (par exemple, nom de fichier) qui ne sont pas des paramètres étendus (qui contiennent un jeu de caractères explicite). Par défaut : `'latin1'`
Dans une application Web moyenne, seul `dest` peut être requis et configuré comme indiqué dans
l'exemple suivant.
```javascript
const upload = multer({ dest: 'uploads/' })
```
Si vous voulez plus de contrôle sur vos téléchargements, vous voudrez utiliser le `storage`
option au lieu de `dest`. Multer est livré avec des moteurs de stockage `DiskStorage`
et `MemoryStorage`; D'autres moteurs sont disponibles auprès de tiers.
#### `.single(fieldname)`
Acceptez un seul fichier avec le nom `fieldname`. Le fichier unique sera stocké
dans `req.file`.
#### `.array(fieldname[, maxCount])`
Acceptez un tableau de fichiers, tous avec le nom `fieldname`. Eventuellement erreur si
plus de `maxCount` fichiers sont téléchargés. Le tableau de fichiers sera stocké dans
`req.files`.
#### `.fields(fields)`
Accepte un mélange de fichiers, spécifié par `fields`. Un objet avec des tableaux de fichiers
seront stockés dans `req.files`.
`fields` doit être un tableau d'objets avec `name` et éventuellement un `maxCount`.
Exemple:
```javascript
[
{ name: 'avatar', maxCount: 1 },
{ name: 'gallery', maxCount: 8 }
]
```
#### `.none()`
N'acceptez que les champs de texte. Si un téléchargement de fichier est effectué, une erreur avec le code
"LIMIT\_UNEXPECTED\_FILE" sera émis.
#### `.any()`
Accepte tous les fichiers qui arrivent sur le fil. Un tableau de fichiers sera stocké dans
`req.files`.
**ATTENTION:** Assurez-vous de toujours gérer les fichiers qu'un utilisateur télécharge.
N'ajoutez jamais multer en tant que middleware global car un utilisateur malveillant pourrait télécharger des
fichiers vers un itinéraire que vous n'aviez pas prévu. N'utilisez cette fonction que sur les itinéraires
où vous gérez les fichiers téléchargés.
### `storage`
#### `DiskStorage`
Le moteur de stockage sur disque vous donne un contrôle total sur le stockage des fichiers sur le disque.
```javascript
const storage = multer.diskStorage({
destination: function (req, file, cb) {
cb(null, '/tmp/my-uploads')
},
filename: function (req, file, cb) {
const uniqueSuffix = Date.now() + '-' + Math.round(Math.random() * 1E9)
cb(null, file.fieldname + '-' + uniqueSuffix)
}
})
const upload = multer({ storage: storage })
```
Il y a deux options disponibles, `destination` et `filename`. Elles sont toutes les deux
des fonctions qui déterminent où le fichier doit être stocké.
`destination` est utilisé pour déterminer dans quel dossier les fichiers téléchargés doivent
être stocké. Cela peut également être donné sous forme de `string` (par exemple `'/tmp/uploads'`). Sinon
`destination` est donné, le répertoire par défaut du système d'exploitation est utilisé pour les
fichiers temporaires.
**Remarque:** Vous êtes responsable de la création du répertoire lorsque vous fournissez
`destination` en tant que fonction. Lors du passage d'une chaîne, multer s'assurera que
le répertoire est créé pour vous.
`filename` est utilisé pour déterminer le nom du fichier dans le dossier.
Si aucun "nom de fichier" n'est donné, chaque fichier recevra un nom aléatoire qui n'inclut
pas d'extension de fichier.
**Remarque:** Multer n'ajoutera aucune extension de fichier pour vous, votre fonction
doit renvoyer un nom de fichier complet avec une extension de fichier.
Chaque fonction reçoit à la fois la requête (`req`) et des informations sur
le dossier (`file`) pour aider à la décision.
Notez que `req.body` n'a peut-être pas encore été entièrement rempli. Cela dépend de l'ordre
où le client transmet les champs et les fichiers au serveur.
Pour comprendre la convention d'appel utilisée dans le rappel (nécessité de passer
null comme premier paramètre), reportez-vous à
[Node.js error handling](https://web.archive.org/web/20220417042018/https://www.joyent.com/node-js/production/design/errors)
#### `MemoryStorage`
Le moteur de stockage en mémoire stocke les fichiers en mémoire en tant qu'objets `Buffer`. Il
n'a pas d'options.
```javascript
const storage = multer.memoryStorage()
const upload = multer({ storage: storage })
```
Lors de l'utilisation du stockage en mémoire, les informations sur le fichier contiendront un champ appelé
`buffer` qui contient le fichier entier.
**ATTENTION**: Le téléchargement de fichiers très volumineux ou de fichiers relativement petits en grand
nombres très rapidement, peut entraîner un manque de mémoire de votre application lorsque
le stockage en mémoire est utilisé.
### `limits`
Un objet spécifiant les limites de taille des propriétés facultatives suivantes. Multer passe directement cet objet dans busboy, et les détails des propriétés peuvent être trouvés sur [la page de busboy](https://github.com/mscdex/busboy#busboy-methods).
Les valeurs entières suivantes sont disponibles :
Clé | Description | Default
--- |---------------------------------------------------------------------------| ---
`fieldNameSize` | Taille maximale du nom de champ | 100 bytes
`fieldSize` | Max field value size (in bytes) | 1MB
`fields` | Taille maximale de la valeur du champ (en octets) | Infinity
`fileSize` | Pour les formulaires multipart, la taille maximale du fichier (en octets) | Infinity
`files` | Pour les formulaires multipart, le nombre maximal de champs de fichier | Infinity
`parts` | Pour les formulaires multipart, le nombre max de parties (champs + fichiers) | Infinity
`headerPairs` | Pour les formulaires multipart, le nombre maximum de paires clé=>valeur d'en-tête à analyser | 2000
Spécifier les limites peut aider à protéger votre site contre les attaques par déni de service (DoS).
### `fileFilter`
Définissez ceci sur une fonction pour contrôler quels fichiers doivent être téléchargés et lesquels
devrait être ignoré. La fonction devrait ressembler à ceci:
```javascript
function fileFilter (req, file, cb) {
// La fonction doit appeler `cb` avec un booléen
// pour indiquer si le fichier doit être accepté
// Pour rejeter ce fichier, passez `false`, comme ceci:
cb(null, false)
// Pour accepter le fichier, passez `true`, comme ceci:
cb(null, true)
// Vous pouvez toujours passer une erreur si quelque chose ne va pas:
cb(new Error('I don\'t have a clue!'))
}
```
## Gestion des Erreurs
En cas d'erreur, Multer déléguera l'erreur à Express. Vous pouvez
afficher une belle page d'erreur en utilisant [la voie express standard](http://expressjs.com/guide/error-handling.html).
Si vous souhaitez détecter les erreurs spécifiquement de Multer, vous pouvez appeler la
fonction middleware par vous-même. Aussi, si vous voulez attraper seulement [les erreurs Multer](https://github.com/expressjs/multer/blob/main/lib/multer-error.js), vous pouvez utiliser la classe `MulterError` qui est jointe à l'objet `multer` lui-même (par exemple `err instanceof multer.MulterError`).
```javascript
const multer = require('multer')
const upload = multer().single('avatar')
app.post('/profile', function (req, res) {
upload(req, res, function (err) {
if (err instanceof multer.MulterError) {
// Une erreur Multer s'est produite lors du téléchargement.
} else if (err) {
// Une erreur inconnue s'est produite lors du téléchargement.
}
// Tout s'est bien passé.
})
})
```
## Moteur de stockage personnalisé
Pour plus d'informations sur la création de votre propre moteur de stockage, consultez [Multer Storage Engine](https://github.com/expressjs/multer/blob/main/StorageEngine.md).
## License
[MIT](LICENSE)
[ci-image]: https://github.com/expressjs/multer/actions/workflows/ci.yml/badge.svg
[ci-url]: https://github.com/expressjs/multer/actions/workflows/ci.yml
[test-url]: https://coveralls.io/r/expressjs/multer?branch=main
[test-image]: https://badgen.net/coveralls/c/github/expressjs/multer/main
[npm-downloads-image]: https://badgen.net/npm/dm/multer
[npm-url]: https://npmjs.org/package/multer
[npm-version-image]: https://badgen.net/npm/v/multer
[ossf-scorecard-badge]: https://api.scorecard.dev/projects/github.com/expressjs/multer/badge
[ossf-scorecard-visualizer]: https://ossf.github.io/scorecard-visualizer/#/projects/github.com/expressjs/multer
expressjs-multer-2e2af08/doc/README-ko.md 0000664 0000000 0000000 00000030641 15213763722 0020126 0 ustar 00root root 0000000 0000000 # Multer [![NPM Version][npm-version-image]][npm-url] [![NPM Downloads][npm-downloads-image]][npm-url] [![Build Status][ci-image]][ci-url] [![Test Coverage][test-image]][test-url] [![OpenSSF Scorecard Badge][ossf-scorecard-badge]][ossf-scorecard-visualizer]
Multer는 파일 업로드를 위해 사용되는 `multipart/form-data` 를 다루기 위한 node.js 의 미들웨어 입니다. 효율성을 최대화 하기 위해 [busboy](https://github.com/mscdex/busboy) 를 기반으로 하고 있습니다.
**주**: Multer는 multipart (`multipart/form-data`)가 아닌 폼에서는 동작하지 않습니다.
## 번역
이 문서는 아래의 언어로도 제공됩니다:
- [العربية](https://github.com/expressjs/multer/blob/main/doc/README-ar.md) (아라비아 말)
- [English](https://github.com/expressjs/multer/blob/main/README.md) (영어)
- [Español](https://github.com/expressjs/multer/blob/main/doc/README-es.md) (스페인어)
- [简体中文](https://github.com/expressjs/multer/blob/main/doc/README-zh-cn.md) (중국어)
- [Русский язык](https://github.com/expressjs/multer/blob/main/doc/README-ru.md) (러시아)
- [Português](https://github.com/expressjs/multer/blob/main/doc/README-pt-br.md) (포르투갈어 BR)
## 설치
```sh
$ npm install --save multer
```
## 사용법
Multer는 `body` 객체와 한 개의 `file` 혹은 여러개의 `files` 객체를 `request` 객체에 추가합니다. `body` 객체는 폼 텍스트 필드의 값을 포함하고, 한 개 혹은 여러개의 파일 객체는 폼을 통해 업로드된 파일들을 포함하고 있습니다.
기본 사용 예제:
```javascript
const express = require('express')
const multer = require('multer')
const upload = multer({ dest: 'uploads/' })
const app = express()
app.post('/profile', upload.single('avatar'), function (req, res, next) {
// req.file 은 `avatar` 라는 필드의 파일 정보입니다.
// 텍스트 필드가 있는 경우, req.body가 이를 포함할 것입니다.
})
app.post('/photos/upload', upload.array('photos', 12), function (req, res, next) {
// req.files 는 `photos` 라는 파일정보를 배열로 가지고 있습니다.
// 텍스트 필드가 있는 경우, req.body가 이를 포함할 것입니다.
})
const uploadMiddleware = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
app.post('/cool-profile', uploadMiddleware, function (req, res, next) {
// req.files는 (String -> Array) 형태의 객체 입니다.
// 필드명은 객체의 key에, 파일 정보는 배열로 value에 저장됩니다.
//
// e.g.
// req.files['avatar'][0] -> File
// req.files['gallery'] -> Array
//
// 텍스트 필드가 있는 경우, req.body가 이를 포함할 것입니다.
})
```
텍스트 전용 multipart 폼을 처리해야 하는 경우, 어떠한 multer 메소드 (`.single()`, `.array()`, `fields()`) 도 사용할 수 있습니다. 아래는 `.array()` 를 사용한 예제 입니다 :
```javascript
const express = require('express')
const app = express()
const multer = require('multer')
const upload = multer()
app.post('/profile', upload.array(), function (req, res, next) {
// req.body는 텍스트 필드를 포함합니다.
})
```
## API
### 파일 정보
각각의 파일은 아래의 정보를 포함하고 있습니다:
Key | Description | Note
--- | --- | ---
`fieldname` | 폼에 정의된 필드 명 |
`originalname` | 사용자가 업로드한 파일 명 |
`encoding` | 파일의 엔코딩 타입 |
`mimetype` | 파일의 Mime 타입 |
`size` | 파일의 바이트(byte) 사이즈 |
`destination` | 파일이 저장된 폴더 | `DiskStorage`
`filename` | `destination` 에 저장된 파일 명 | `DiskStorage`
`path` | 업로드된 파일의 전체 경로 | `DiskStorage`
`buffer` | 전체 파일의 `Buffer` | `MemoryStorage`
### `multer(opts)`
Multer는 옵션 객체를 허용합니다. 그 중 가장 기본 옵션인 `dest` 요소는 Multer에게 파일을 어디로 업로드 할 지를 알려줍니다. 만일 옵션 객체를 생략했다면, 파일은 디스크가 아니라 메모리에 저장될 것 입니다.
기본적으로 Multer는 이름이 중복되는 것을 방지하기 위해서 파일의 이름을 재작성 합니다. 필요에 따라 해당 함수는 커스터마이징이 가능합니다.
Multer로 전달 가능한 옵션들은 다음과 같습니다.
Key | Description
--- | ---
`dest` or `storage` | 파일이 저장될 위치
`fileFilter` | 어떤 파일을 허용할지 제어하는 함수
`limits` | 업로드 된 데이터의 한도
`preservePath` | 파일의 base name 대신 보존할 파일의 전체 경로
`defParamCharset` | 확장 매개변수가 아닌 부분 헤더 매개변수 값(예: 파일명)에 사용할 기본 문자 집합(명시적 문자 집합을 포함하지 않음). 기본값: `'latin1'`
보통의 웹 앱에서는 `dest` 옵션 정도만 필요할지도 모릅니다. 설정 방법은 아래의 예제에 나와있습니다.
```javascript
const upload = multer({ dest: 'uploads/' })
```
만일 업로드를 더 제어하고 싶다면, `dest` 옵션 대신 `storage` 옵션을 사용할 수 있습니다. Multer는 스토리지 엔진인 `DiskStorage` 와 `MemoryStorage` 를 탑재하고 있습니다. 써드파티로부터 더 많은 엔진들을 사용할 수 있습니다.
#### `.single(fieldname)`
`fieldname` 인자에 명시된 이름의 단수 파일을 전달 받습니다. 이 파일은 `req.file` 에 저장될 것 입니다.
#### `.array(fieldname[, maxCount])`
`fieldname` 인자에 명시된 이름의 파일 전부를 배열 형태로 전달 받습니다. 선택적으로 `maxCount` 에 명시된 값 이상의 파일이 업로드 될 경우 에러를 출력할 수 있습니다. 전달 된 배열 형태의 파일은 `req.files` 에 저장될 것입니다.
#### `.fields(fields)`
`fields` 인자에 명시된 여러 파일을 전달 받습니다. 파일 객체는 배열 형태로 `req.files` 에 저장될 것입니다.
`fields` 는 `name` 과 `maxCount` (선택사항) 을 포함하는 객체의 배열이어야 합니다.
예제:
```javascript
[
{ name: 'avatar', maxCount: 1 },
{ name: 'gallery', maxCount: 8 }
]
```
#### `.none()`
오직 텍스트 필드만 허용합니다. 만일 파일이 업로드 되었을 경우, "LIMIT\_UNEXPECTED\_FILE" 와 같은 에러 코드가 발생할 것입니다. 이는 `upload.fields([])` 와 같은 동작을 합니다.
#### `.any()`
전달된 모든 파일을 허용합니다. 파일 배열은 `req.files` 에 저장될 것입니다.
**주의:** 항상 사용자가 업로드한 파일을 다룬다는 점을 명심하세요. 악의적인 사용자가 여러분이 예측하지 못한 곳으로 파일을 업로드 할 수 있으므로 절대 multer를 글로벌 미들웨어로 사용하지 마세요.
### `storage`
#### `DiskStorage`
디스크 스토리지 엔진은 파일을 디스크에 저장하기 위한 모든 제어 기능을 제공합니다.
```javascript
const storage = multer.diskStorage({
destination: function (req, file, cb) {
cb(null, '/tmp/my-uploads')
},
filename: function (req, file, cb) {
cb(null, file.fieldname + '-' + Date.now())
}
})
const upload = multer({ storage: storage })
```
`destination` 과 `filename` 의 두가지 옵션이 가능합니다. 두 옵션 모두 파일을 어디에 저장할 지를 정하는 함수입니다.
`destination` 옵션은 어느 폴더안에 업로드 한 파일을 저장할 지를 결정합니다. 이는 `string` 형태로 주어질 수 있습니다 (예. `'/tmp/uploads'`). 만일 `destination` 옵션이 주어지지 않으면, 운영체제 시스템에서 임시 파일을 저장하는 기본 디렉토리를 사용합니다.
**주:** `destination` 을 함수로 사용할 경우, 디렉토리를 생성해야 할 책임이 있습니다. 문자열이 전달될 때, multer는 해당 디렉토리가 생성되었는지 확인합니다.
`filename` 은 폴더안에 저장되는 파일 명을 결정하는데 사용됩니다.
만일 `filename` 이 주어지지 않는다면, 각각의 파일은 파일 확장자를 제외한 랜덤한 이름으로 지어질 것입니다.
**주:** Multer는 어떠한 파일 확장자도 추가하지 않습니다. 사용자 함수는 파일 확장자를 온전히 포함한 파일명을 반환해야 합니다.
결정을 돕기 위해 각각의 함수는 요청 정보 (`req`) 와 파일 (`file`) 에 대한 정보를 모두 전달 받습니다.
`req.body` 는 완전히 채워지지 않았을 수도 있습니다. 이는 클라이언트가 필드와 파일을 서버로 전송하는 순서에 따라 다릅니다.
#### `MemoryStorage`
메모리 스토리지 엔진은 파일을 메모리에 `Buffer` 객체로 저장합니다. 이에 대해서는 어떤 옵션도 없습니다.
```javascript
const storage = multer.memoryStorage()
const upload = multer({ storage: storage })
```
메모리 스토리지 사용시, 파일 정보는 파일 전체를 포함하는 `buffer` 라고 불리는 필드를 포함할 것입니다.
**주의**: 메모리 스토리지를 사용시, 매우 큰 사이즈의 파일을 업로드 하거나 많은 양의 비교적 작은 파일들을 매우 빠르게 업로드 하는 경우 응용 프로그램의 메모리 부족이 발생 할 수 있습니다.
### `limits`
다음의 선택적 속성의 크기 제한을 지정하는 객체입니다. Multer 는 이 객체를 busboy로 직접 전달합니다. 속성들에 대한 자세한 내용은 [busboy's page](https://github.com/mscdex/busboy#busboy-methods) 에서 확인 하실 수 있습니다.
다음과 같은 정수 값들이 가능합니다:
속성 | 설명 | 기본값
--- | --- | ---
`fieldNameSize` | 필드명 사이즈 최대값 | 100 bytes
`fieldSize` | 필드값 사이즈 최대값 | 1MB
`fields` | 파일형식이 아닌 필드의 최대 개수 | 무제한
`fileSize` | multipart 형식 폼에서 최대 파일 사이즈(bytes) | 무제한
`files` | multipart 형식 폼에서 파일 필드의 최대 개수 | 무제한
`parts` | For multipart forms, the max number of parts (fields + files) | 무제한
`headerPairs` | multipart 형식 폼에서 파싱할 헤더의 key=>value 쌍의 최대 개수| 2000
사이즈 제한을 지정하면 서비스 거부 (DoS) 공격으로부터 사이트를 보호하는데 도움이 됩니다.
### `fileFilter`
어느 파일을 업로드 할지, 혹은 건너뛸지 제어할 수 있게 함수에 설정합니다. 해당 함수는 아래와 같을 것입니다 :
```javascript
function fileFilter (req, file, cb) {
// 이 함수는 boolean 값과 함께 `cb`를 호출함으로써 해당 파일을 업로드 할지 여부를 나타낼 수 있습니다.
// 이 파일을 거부하려면 다음과 같이 `false` 를 전달합니다:
cb(null, false)
// 이 파일을 허용하려면 다음과 같이 `true` 를 전달합니다:
cb(null, true)
// 무언가 문제가 생겼다면 언제나 에러를 전달할 수 있습니다:
cb(new Error('I don\'t have a clue!'))
}
```
## 에러 핸들링
에러가 발생할 때, multer는 에러를 express에 위임할 것입니다. 여러분은 [the standard express way](http://expressjs.com/guide/error-handling.html) 를 이용해서 멋진 오류 페이지를 보여줄 수 있습니다.
만일 multer 로부터 특별히 에러를 캐치하고 싶다면, 직접 미들웨어 함수를 호출하세요.
```javascript
const upload = multer().single('avatar')
app.post('/profile', function (req, res) {
upload(req, res, function (err) {
if (err) {
// 업로드할때 오류가 발생함
return
}
// 정상적으로 완료됨
})
})
```
## 커스텀 스토리지 엔진
자신만의 고유한 스토리지 엔진을 구축하기 위한 정보를 얻기 위해서는 [Multer Storage Engine](https://github.com/expressjs/multer/blob/main/StorageEngine.md) 문서를 참고하세요.
## 라이센스
[MIT](LICENSE)
[ci-image]: https://github.com/expressjs/multer/actions/workflows/ci.yml/badge.svg
[ci-url]: https://github.com/expressjs/multer/actions/workflows/ci.yml
[test-url]: https://coveralls.io/r/expressjs/multer?branch=main
[test-image]: https://badgen.net/coveralls/c/github/expressjs/multer/main
[npm-downloads-image]: https://badgen.net/npm/dm/multer
[npm-url]: https://npmjs.org/package/multer
[npm-version-image]: https://badgen.net/npm/v/multer
[ossf-scorecard-badge]: https://api.scorecard.dev/projects/github.com/expressjs/multer/badge
[ossf-scorecard-visualizer]: https://ossf.github.io/scorecard-visualizer/#/projects/github.com/expressjs/multer
expressjs-multer-2e2af08/doc/README-pt-br.md 0000664 0000000 0000000 00000033152 15213763722 0020541 0 ustar 00root root 0000000 0000000 # Multer [![NPM Version][npm-version-image]][npm-url] [![NPM Downloads][npm-downloads-image]][npm-url] [![Build Status][ci-image]][ci-url] [![Test Coverage][test-image]][test-url] [![OpenSSF Scorecard Badge][ossf-scorecard-badge]][ossf-scorecard-visualizer]
Multer é um middleware node.js para manipulação `multipart/form-data`, que é usado principalmente para fazer upload de arquivos. Foi escrito em cima do [busboy](https://github.com/mscdex/busboy) para máxima eficiência.
**NOTA**: Multer não processará nenhum formulário que não seja multipart (`multipart/form-data`).
## Traduções
Este README também está disponível em outros idiomas:
- [English](https://github.com/expressjs/multer/blob/main/README.md) (Inglês)
- [العربية](https://github.com/expressjs/multer/blob/main/doc/README-ar.md) (Árabe)
- [Español](https://github.com/expressjs/multer/blob/main/doc/README-es.md) (Espanhol)
- [简体中文](https://github.com/expressjs/multer/blob/main/doc/README-zh-cn.md) (Chinês)
- [한국어](https://github.com/expressjs/multer/blob/main/doc/README-ko.md) (Coreano)
- [Русский язык](https://github.com/expressjs/multer/blob/main/doc/README-ru.md) (Russo)
- [Việt Nam](https://github.com/expressjs/multer/blob/main/doc/README-vi.md) (Vietnã)
- [Português](https://github.com/expressjs/multer/blob/main/doc/README-pt-br.md) (Português Brasil)
- [Français](https://github.com/expressjs/multer/blob/main/doc/README-fr.md) (Francês)
- [O'zbek tili](https://github.com/expressjs/multer/blob/main/doc/README-uz.md) (Uzbequistão)
## Instalação
```sh
$ npm install --save multer
```
## Uso
Multer adiciona um objeto `body` e um `file` ou objeto `files` para objeto `request`. O objeto `body` contém os valores dos campos de texto do formulário, o objeto `file` ou `files` contém os arquivos enviados por meio do formulário.
Exemplo de uso básico:
Não esqueça o `enctype="multipart/form-data"` em seu formulário.
```html
```
```javascript
const express = require('express')
const multer = require('multer')
const upload = multer({ dest: 'uploads/' })
const app = express()
app.post('/profile', upload.single('avatar'), function (req, res, next) {
// req.file é um arquivo `avatar`
// req.body conterá os campos de texto, se houver
})
app.post('/photos/upload', upload.array('photos', 12), function (req, res, next) {
// req.files é um array de arquivos `photos`
// req.body conterá os campos de texto, se houver
})
const uploadMiddleware = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
app.post('/cool-profile', uploadMiddleware, function (req, res, next) {
// req.files é um objeto (String -> Array) onde fieldname é a chave e o valor é array de arquivos
//
// e.g.
// req.files['avatar'][0] -> File
// req.files['gallery'] -> Array
//
// req.body conterá os campos de texto, se houver
})
```
Caso você precise lidar com formulário text-only multipart, você deve usar o método `.none()`:
```javascript
const express = require('express')
const app = express()
const multer = require('multer')
const upload = multer()
app.post('/profile', upload.none(), function (req, res, next) {
// req.body contém os campos de texto
})
```
Aqui está um exemplo de como o multer é usado em um formulário HTML. Onde adicionamos `enctype="multipart/form-data"` no form e no input `name="uploaded_file"`:
```html
```
Então, em seu arquivo javascript, você adicionaria essas linhas para acessar o arquivo e o corpo. É importante que você use o valor do campo `name` do formulário em sua função de upload. Isso informa ao multer em qual campo da solicitação ele deve procurar os arquivos. Se esses campos não forem iguais no formulário HTML e no seu servidor, seu upload falhará:
```javascript
const multer = require('multer')
const upload = multer({ dest: './public/data/uploads/' })
app.post('/stats', upload.single('uploaded_file'), function (req, res) {
// req.fileé o nome do seu arquivo no formato acima, aqui 'uploaded_file'
// req.body irá conter os campos de texto, se houver algum
console.log(req.file, req.body)
});
```
## API
### Informação de arquivo
Cada arquivo contém as seguintes informações:
Key | Descrição | Nota
--- | --- | ---
`fieldname` | Nome do campo especificado no formulário |
`originalname` | Nome do arquivo no computador do usuário |
`encoding` | Tipo de codificação do arquivo |
`mimetype` | Tipo Mime do arquivo |
`size` | Tamanho do arquivo em bytes |
`destination` | A pasta na qual o arquivo foi salvo | `DiskStorage`
`filename` | O nome do arquivo dentro do `destination` | `DiskStorage`
`path` | O caminho completo para o arquivo enviado | `DiskStorage`
`buffer` | O `Buffer` do arquivo inteiro | `MemoryStorage`
### `multer(opts)`
Multer aceita um objeto de opções, a propriedade mais básica é o `dest`, que diz ao Multer onde fazer o upload dos arquivos. No caso de você omitir o objeto de opções, os arquivos serão mantidos na memória e nunca gravados no disco.
Por padrão, Multer irá renomear os arquivos para evitar conflitos de nomes. A função de renomeação pode ser personalizada de acordo com suas necessidades.
A seguir estão as opções que podem ser passadas para o Multer.
Key | Descrição
--- | ---
`dest` ou `storage` | Onde armazenar os arquivos
`fileFilter` | Função para controlar quais arquivos são aceitos
`limits` | Limites dos dados enviados
`preservePath` | Mantenha o caminho completo dos arquivos em vez de apenas o nome base
`defParamCharset` | Conjunto de caracteres padrão para usar em valores de parâmetros de cabeçalho de parte (por exemplo, nome do arquivo) que não são parâmetros estendidos (que contêm um conjunto de caracteres explícito). Padrão: `'latin1'`
Em um web app básico, somente o `dest` pode ser necessário, e configurado como mostrado no exemplo a seguir:
```javascript
const upload = multer({ dest: 'uploads/' })
```
Se você quiser mais controle sobre seus envios, você ter que usar a opção `storage` em vez de `dest`. Multer vem com motores de armazenamento `DiskStorage` e `MemoryStorage`; Mais mecanismos estão disponíveis de terceiros.
#### `.single(fieldname)`
Aceite um único arquivo com o nome `fieldname`. O arquivo único será armazenado em `req.file`.
#### `.array(fieldname[, maxCount])`
Aceite múltiplos arquivos, todos com o nome `fieldname`. Opcional, gera um erro se forem enviados mais de `maxCount`. O array de arquivos serão armazenados em
`req.files`.
#### `.fields(fields)`
Aceita uma mistura de arquivos, especificada por `fields`. Um objeto com um array de arquivos será armazenado em `req.files`.
`fields` deve ser uma matriz de objetos com `name` e opcionalmente com `maxCount`.
Exemplo:
```javascript
[
{ name: 'avatar', maxCount: 1 },
{ name: 'gallery', maxCount: 8 }
]
```
#### `.none()`
Aceite apenas campo de texto. Se algum upload de arquivo for feito, um erro com código "LIMIT\_UNEXPECTED\_FILE" será emitido.
#### `.any()`
Aceita todos os arquivos que são enviados. Uma matriz de arquivos será armazenada em
`req.files`.
**AVISO:** Certifique-se de sempre manipular os arquivos que um usuário envia.
Nunca adicione o Multer como global no middleware, já que um usuário mal-intencionado poderia fazer upload de arquivos para uma rota que você não previu. Use esta função apenas nas rotas onde você está lidando com os arquivos enviados.
### `storage`
#### `DiskStorage`
O mecanismo de armazenamento em disco oferece controle total sobre o armazenamento de arquivos em disco.
```javascript
const storage = multer.diskStorage({
destination: function (req, file, cb) {
cb(null, '/tmp/my-uploads')
},
filename: function (req, file, cb) {
cb(null, file.fieldname + '-' + Date.now())
}
})
const upload = multer({ storage: storage })
```
Existem duas opções disponíveis, `destination` e `filename`. Ambas são funções que determinam onde o arquivo deve ser armazenado.
`destination` é usado para determinar em qual pasta os arquivos enviados devem ser armazenados. Isso também pode ser dado como uma `string` (e.g. `'/tmp/uploads'`). Se não é dada `destination`, o diretório padrão do sistema operacional para arquivos temporários é usado.
**Nota:** Você é responsável por criar o diretório ao fornecer o "destino" com uma função. Ao passar uma string, o Multer se certificará de que o diretório foi criado para você.
`filename` é usado para determinar qual arquivo deve ser nomeado dentro da pasta.
Se não for passado `filename`, cada arquivo receberá um nome aleatório que não inclui nenhuma extensão de arquivo.
**Nota:** Multer não adicionará nenhuma extensão de arquivo para você, sua função é retornar um nome para o arquivo completo com a extensão de arquivo.
Cada função é passada pelo request (`req`) e algumas informações sobre o arquivo (`file`) para ajudar com a decisão.
Observe que `req.body` pode não ter sido totalmente preenchido ainda. Isso depende da ordem na qual o cliente transmite campos e arquivos para o servidor.
Para entender a convenção de chamada usada no callback (precisando passar
null como o primeiro parâmetro), consulte em
[Manipulação de erros no Node.js](https://web.archive.org/web/20220417042018/https://www.joyent.com/node-js/production/design/errors)
#### `MemoryStorage`
O mecanismo de armazenamento na memória, armazena os arquivos na memória como um objeto `Buffer`. Não tendo opções.
```javascript
const storage = multer.memoryStorage()
const upload = multer({ storage: storage })
```
Ao usar o armazenamento de memória, as informações do arquivo conterão um campo chamado `buffer` que contém o arquivo inteiro.
**AVISO**: Fazer upload de arquivos muito grandes ou arquivos relativamente pequenos em grande número muito rapidamente pode fazer com que o aplicativo fique sem memória quando o armazenamento de memória é usado.
### `limits`
Um objeto que especifica os limites de tamanho das seguintes propriedades opcionais. O Multer passa diretamente o objeto para o busboy, e os detalhes das propriedades podem ser encontrados em [busboy's page](https://github.com/mscdex/busboy#busboy-methods).
Os seguintes valores inteiros estão disponíveis:
Key | Descrição | Padrão
--- | --- | ---
`fieldNameSize` | Tamanho máximo do nome de campo| 100 bytes
`fieldSize` | Tamanho máximo do valor do campo (in bytes) | 1MB
`fields` | Max number of non-file fields | Infinity
`fileSize` | Para formulários multipart, o tamanho máximo do arquivo (in bytes) | Infinity
`files` | Para formulários multipart, o número máximo de campos de arquivos | Infinity
`parts` | Para formulários multipart, o número máximo de parts (fields + files) | Infinity
`headerPairs` | Para formulários multipart, o número máximo do header key=>value, para analisar | 2000
A especificação dos limites pode ajudar a proteger seu site contra ataques de negação de serviço (DoS).
### `fileFilter`
Defina isso para uma função para controlar quais arquivos devem ser enviados e quais devem ser ignorados.
A função deve ficar assim:
```javascript
function fileFilter (req, file, cb) {
// A função deve chamar `cb` com um booleano
// para indicar se o arquivo deve ser aceito
// Para rejeitar este arquivo passe `false`, assim:
cb(null, false)
// Para aceitar o arquivo passe `true`, assim:
cb(null, true)
// Você sempre pode passar um erro se algo der errado:
cb(new Error('I don\'t have a clue!'))
}
```
## Error handling
Quando encontrar um erro, Multer delegará o erro para Express. Você pode exibir uma boa página de erro usando [the standard express way](http://expressjs.com/guide/error-handling.html).
Se você quer pegar erros especificamente do Multer, você pode enviar para o função de middleware. Além disso, se você quiser pegar apenas [os erros do Multer](https://github.com/expressjs/multer/blob/main/lib/multer-error.js), você pode usar a classe `MulterError` que está ligado ao objeto `multer` (e.g. `err instanceof multer.MulterError`).
```javascript
const multer = require('multer')
const upload = multer().single('avatar')
app.post('/profile', function (req, res) {
upload(req, res, function (err) {
if (err instanceof multer.MulterError) {
// Ocorreu um erro durante o upload.
} else if (err) {
// Ocorreu um erro durante o upload.
}
// Tudo correu bem.
})
})
```
## Mecanismo de armazenamento personalizado
Para obter informações sobre como criar seu próprio mecanismo de armazenamento, veja [Multer Storage Engine](https://github.com/expressjs/multer/blob/main/StorageEngine.md).
## Licença
[MIT](LICENSE)
[ci-image]: https://github.com/expressjs/multer/actions/workflows/ci.yml/badge.svg
[ci-url]: https://github.com/expressjs/multer/actions/workflows/ci.yml
[test-url]: https://coveralls.io/r/expressjs/multer?branch=main
[test-image]: https://badgen.net/coveralls/c/github/expressjs/multer/main
[npm-downloads-image]: https://badgen.net/npm/dm/multer
[npm-url]: https://npmjs.org/package/multer
[npm-version-image]: https://badgen.net/npm/v/multer
[ossf-scorecard-badge]: https://api.scorecard.dev/projects/github.com/expressjs/multer/badge
[ossf-scorecard-visualizer]: https://ossf.github.io/scorecard-visualizer/#/projects/github.com/expressjs/multer
expressjs-multer-2e2af08/doc/README-ru.md 0000664 0000000 0000000 00000037715 15213763722 0020154 0 ustar 00root root 0000000 0000000 # Multer [![NPM Version][npm-version-image]][npm-url] [![NPM Downloads][npm-downloads-image]][npm-url] [![Build Status][ci-image]][ci-url] [![Test Coverage][test-image]][test-url] [![OpenSSF Scorecard Badge][ossf-scorecard-badge]][ossf-scorecard-visualizer]
Multer — это middleware для фреймворка express для обработки `multipart/form-data`, нужная в первую очередь при загрузке файлов. Написана как обертка над [busboy](https://github.com/mscdex/busboy) для ее максимально эффективного использования.
**ВАЖНО**: Multer не обрабатывает никакой другой тип форм, кроме `multipart/form-data`.
## Переводы
Это README также доступно на других языках:
- [العربية](https://github.com/expressjs/multer/blob/main/doc/README-ar.md) (арабский)
- [English](https://github.com/expressjs/multer/blob/main/README.md) (Английский)
- [Español](https://github.com/expressjs/multer/blob/main/doc/README-es.md) (Испанский)
- [简体中文](https://github.com/expressjs/multer/blob/main/doc/README-zh-cn.md) (Китайский)
- [한국어](https://github.com/expressjs/multer/blob/main/doc/README-ko.md) (Корейский)
- [Português](https://github.com/expressjs/multer/blob/main/doc/README-pt-br.md) (бр Португальский)
## Установка
```sh
$ npm install --save multer
```
## Использование
Multer добавляет объект `body` и объект `file` (или `files`) внутрь объекта `request`. Объект `body` содержит значения текстовых полей формы, объект `file` (`files`) содержит файл или файлы, загружаемые через форму.
Простой пример использования:
Не забывайте про `enctype="multipart/form-data"` в вашей форме.
```html
```
```javascript
const express = require('express')
const multer = require('multer')
const upload = multer({ dest: 'uploads/' })
const app = express()
app.post('/profile', upload.single('avatar'), function (req, res, next) {
// req.file - файл `avatar`
// req.body сохранит текстовые поля, если они будут
})
app.post('/photos/upload', upload.array('photos', 12), function (req, res, next) {
// req.files - массив файлов `photos`
// req.body сохранит текстовые поля, если они будут
})
const uploadMiddleware = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
app.post('/cool-profile', uploadMiddleware, function (req, res, next) {
// req.files - объект (String -> Array), где fieldname - ключ, и значение - массив файлов
//
// например:
// req.files['avatar'][0] -> File
// req.files['gallery'] -> Array
//
// req.body сохранит текстовые поля, если они будут
})
```
Если вам нужно обработать multipart-форму, содержащую только текст, используйте метод `.none()`:
```javascript
const express = require('express')
const app = express()
const multer = require('multer')
const upload = multer()
app.post('/profile', upload.none(), function (req, res, next) {
// req.body содержит текстовые поля
})
```
## API
### Информация о файлах
Каждый файл содержит следующую информацию:
Ключ | Описание | Замечания
--- | --- | ---
`fieldname` | Имя поля, заданное в форме |
`originalname` | Имя файла на компьютере пользователя |
`encoding` | Кодировка файла |
`mimetype` | Mime-тип файла |
`size` | Размер файла в байтах |
`destination` | Каталог, где будет сохранен файл | `DiskStorage`
`filename` | Имя файла без `destination` | `DiskStorage`
`path` | Полный путь к загружаемому файлу | `DiskStorage`
`buffer` | `Buffer` из всего файла | `MemoryStorage`
### `multer(opts)`
Multer принимает объект с опциями. Базовая опция `dest` указывает Multer, куда загружать файлы. Если вы не указываете объект с опциями, файлы будут находиться в памяти и не будут записаны на диск.
По умолчанию, Multer переименовывает файлы, чтобы избежать конфликтов. Это настраиваемо под ваши потребности.
Следующие опции могут быть переданы Multer.
Ключ | Описание
--- | ---
`dest` или `storage` | Где сохранять файлы
`fileFilter` | Функция для контроля принятия файлов
`limits` | Ограничения по загрузке
`preservePath` | Сохранять полный путь к файлам вместо только базового имени
`defParamCharset` | Кодировка по умолчанию для значений параметров заголовков частей (например, имя файла), которые не являются расширенными параметрами (не содержат явную кодировку). По умолчанию: `'latin1'`
Обычно для веб-приложения нужно обязательно переопределить `dest`, как показано в примере ниже.
```javascript
const upload = multer({ dest: 'uploads/' })
```
Если вам нужно больше возможностей для управления приложением, можно использовать `storage` вместо `dest`. Multer поставляется с двумя движками работы с памятью, `DiskStorage` и `MemoryStorage`, другие движки можно найти у сторонних разработчиков.
#### `.single(fieldname)`
Принимает один файл с именем `fieldname`. Файл будет сохранен в `req.file`.
#### `.array(fieldname[, maxCount])`
Принимает массив файлов с именем `fieldname`. Опционально можно задать ошибку при попытке загрузки более `maxCount` файлов. Массив файлов будет сохранен в `req.files`.
#### `.fields(fields)`
Принимает набор файлов, определенных в `fields`. Объект с массивом файлов будет сохранен в `req.files`.
`fields` должен быть массивом объектов с полями `name` и опциональным `maxCount`.
Например:
```javascript
[
{ name: 'avatar', maxCount: 1 },
{ name: 'gallery', maxCount: 8 }
]
```
#### `.none()`
Принимает только текстовые поля формы. При попытке загрузки файла падает с ошибкой "LIMIT\_UNEXPECTED\_FILE".
#### `.any()`
Принимает все переданные файлы. Массив файлов будет сохранен в `req.files`.
**ПРЕДУПРЕЖДЕНИЕ:** Убедитесь в корректной обработке загрузки файлов вашим приложением. Никогда не используйте Multer как middleware глобально, если пользователь может загрузить вредоносные файлы, и тем самым нарушить работу вашего приложения. Используйте этот метод, только если вы полностью управляете процессом загрузки файлов.
### `storage`
#### `DiskStorage`
Движок дискового пространства. Дает полный контроль над размещением файлов на диск.
```javascript
const storage = multer.diskStorage({
destination: function (req, file, cb) {
cb(null, '/tmp/my-uploads')
},
filename: function (req, file, cb) {
cb(null, file.fieldname + '-' + Date.now())
}
})
const upload = multer({ storage: storage })
```
Доступно две опции, расположение `destination` и имя файла `filename`. Обе эти функции определяют, где будет находиться файл после загрузки.
`destination` используется, чтобы задать каталог, в котором будут размещены файлы. Может быть задан строкой (например, `'/tmp/uploads'`). Если не задано расположение `destination`, операционная система воспользуется для сохранения каталогом для временных файлов.
**Важно:** Вы должны создать каталог, когда используете `destination`. При передачи в качестве аргумента строки, Multer проверяет, что каталог создан.
`filename` используется, чтобы определить, как будет назван файл внутри каталога. Если
имя файла `filename` не задано, каждому файлу будет сконфигурировано случайное имя без расширения файла.
**Важно:** Multer не добавляет никакого файлового расширения, ваша функция должна возвращать имя файла с необходимым расширением.
В аргументах каждой функции прокидывается запрос (`req`) и набор информации о файле (`file`).
Обратите внимание, что `req.body` может быть не полностью заполнено. Это зависит от порядка отправки клиентом полей и файлов на сервер.
#### `MemoryStorage`
Движок оперативной памяти сохраняет файлы в памяти как объекты типа `Buffer`. В этом случае нет никаких дополнительных опций.
```javascript
const storage = multer.memoryStorage()
const upload = multer({ storage: storage })
```
Когда вы используете этот тип передачи, информация о файле будет содержать поле `buffer`, которое содержит весь файл.
**ПРЕДУПРЕЖДЕНИЕ**: Загрузка очень больших файлов, или относительно небольших файлов в большом количестве может вызвать переполнение памяти.
### `limits`
Объект, устанавливающий ограничения. Multer прокидывает этот объект напрямую в busboy, поэтому детали можно посмотреть
[на странице с методами busboy](https://github.com/mscdex/busboy#busboy-methods).
Доступны следующие целочисленные значения:
Ключ | Описание | Значение по умолчанию
--- | --- | ---
`fieldNameSize` | Максимальный размер имени файла | 100 bytes
`fieldSize` | Максимальный размер значения поля | 1MB
`fields` | Максимальное количество не-файловых полей | Не ограничено
`fileSize` | Максимальный размер файла в байтах для multipart-форм | Не ограничен
`files` | Максимальное количество полей с файлами для multipart-форм | Не ограничено
`parts` | Максимальное количество полей с файлами для multipart-форм (поля плюс файлы) | Не ограничено
`headerPairs` | Максимальное количество пар ключ-значение key=>value для multipart-форм, которое обрабатывается | 2000
Установка ограничений может помочь защитить ваш сайт от DoS-атак.
### `fileFilter`
Задают функцию для того, чтобы решать, какие файлы будут загружены, а какие — нет. Функция может выглядеть так:
```javascript
function fileFilter (req, file, cb) {
// Функция должна вызывать `cb` с булевым значением,
// которое показывает, следует ли принять файл
// Чтобы отклонить, прокиньте в аргументы `false` так:
cb(null, false)
// Чтобы принять файл, используется как аргумент `true` таким образом:
cb(null, true)
// Вы можете всегда вернуть ошибку, если что-то пошло не так:
cb(new Error('I don\'t have a clue!'))
}
```
## Обработка ошибок
Когда выбрасывается исключение, Multer делегирует его обработку Express. Вы можете выводить страницу ошибки [стандартными для express способами](http://expressjs.com/guide/error-handling.html).
Если вы хотите отлавливать ошибки конкретно от Multer, вам нужно вызывать собственную middleware для их обработки. Еще, если вы хотите отлавливать [исключительно ошибки Multer](https://github.com/expressjs/multer/blob/main/lib/make-error.js#L1-L9), вы можете использовать класс `MulterError`, который привязан к объекту `multer` (например, `err instanceof multer.MulterError`)
```javascript
const multer = require('multer')
const upload = multer().single('avatar')
app.post('/profile', function (req, res) {
upload(req, res, function (err) {
if (err instanceof multer.MulterError) {
// Случилась ошибка Multer при загрузке.
} else {
// При загрузке произошла неизвестная ошибка.
}
// Все прекрасно загрузилось.
})
})
```
## Собственные движки для сохранения файлов
Чтобы получить информацию, как создать собственный движок для обработки загрузки файлов, смотрите страницу [Multer Storage Engine](https://github.com/expressjs/multer/blob/main/StorageEngine.md).
## Лицензия
[MIT](LICENSE)
[ci-image]: https://github.com/expressjs/multer/actions/workflows/ci.yml/badge.svg
[ci-url]: https://github.com/expressjs/multer/actions/workflows/ci.yml
[test-url]: https://coveralls.io/r/expressjs/multer?branch=main
[test-image]: https://badgen.net/coveralls/c/github/expressjs/multer/main
[npm-downloads-image]: https://badgen.net/npm/dm/multer
[npm-url]: https://npmjs.org/package/multer
[npm-version-image]: https://badgen.net/npm/v/multer
[ossf-scorecard-badge]: https://api.scorecard.dev/projects/github.com/expressjs/multer/badge
[ossf-scorecard-visualizer]: https://ossf.github.io/scorecard-visualizer/#/projects/github.com/expressjs/multer
expressjs-multer-2e2af08/doc/README-tr.md 0000664 0000000 0000000 00000035133 15213763722 0020143 0 ustar 00root root 0000000 0000000 # Multer [![NPM Version][npm-version-image]][npm-url] [![NPM Downloads][npm-downloads-image]][npm-url] [![Build Status][ci-image]][ci-url] [![Test Coverage][test-image]][test-url] [![OpenSSF Scorecard Badge][ossf-scorecard-badge]][ossf-scorecard-visualizer]
Multer, `multipart/form-data` tipi formları işlemek için kullanılan bir Node.js middleware’idir ve genellikle dosya yükleme işlemlerinde kullanılır.
Maksimum verimlilik için [busboy](https://github.com/mscdex/busboy) üzerine yazılmıştır.
**NOT:** Multer, `multipart/form-data` olmayan formları işlemeyecektir.
## Çeviriler
Bu README dosyası ayrıca diğer dillerde de mevcuttur:
| | |
| ------------------------------------------------------------------------------ | --------------- |
| [العربية](https://github.com/expressjs/multer/blob/main/doc/README-ar.md) | Arapça |
| [简体中文](https://github.com/expressjs/multer/blob/main/doc/README-zh-cn.md) | Çince |
| [Français](https://github.com/expressjs/multer/blob/main/doc/README-fr.md) | Fransızca |
| [한국어](https://github.com/expressjs/multer/blob/main/doc/README-ko.md) | Korece |
| [Português](https://github.com/expressjs/multer/blob/main/doc/README-pt-br.md) | Brezilya Portekizcesi |
| [Русский язык](https://github.com/expressjs/multer/blob/main/doc/README-ru.md) | Rusça |
| [Español](https://github.com/expressjs/multer/blob/main/doc/README-es.md) | İspanyolca |
| [O'zbek tili](https://github.com/expressjs/multer/blob/main/doc/README-uz.md) | Özbekçe |
| [Việt Nam](https://github.com/expressjs/multer/blob/main/doc/README-vi.md) | Vietnamca |
| [Türkçe](https://github.com/expressjs/multer/blob/main/doc/README-tr.md) | Türkçe |
## Kurulum
```sh
$ npm install multer
```
## Kullanım
Multer, `request` nesnesine bir `body` nesnesi ve bir `file` veya `files` nesnesi ekler. `body` nesnesi formdaki metin alanlarının değerlerini içerir; `file` veya `files` nesnesi ise form aracılığıyla yüklenen dosyaları içerir.
Temel kullanım örneği:
Formunuzda enctype="multipart/form-data" eklemeyi unutmayın.
```html
```
```javascript
const express = require("express");
const multer = require("multer");
const upload = multer({ dest: "uploads/" });
const app = express();
app.post("/profile", upload.single("avatar"), function (req, res, next) {
// req.file `avatar` dosyasıdır
// req.body varsa formdaki metin alanlarını tutar
});
app.post(
"/photos/upload",
upload.array("photos", 12),
function (req, res, next) {
// req.files `photos` dosyalarının dizisidir
// req.body varsa metin alanlarını içerir
}
);
const uploadMiddleware = upload.fields([
{ name: "avatar", maxCount: 1 },
{ name: "gallery", maxCount: 8 },
]);
app.post("/cool-profile", uploadMiddleware, function (req, res, next) {
// req.files bir nesnedir (String -> Array) ve burada fieldname (alan adı) anahtar, değer ise dosyaların bulunduğu bir dizidir.
// Örneğin:
// req.files['avatar'][0] -> File
// req.files['gallery'] -> Array
//
// req.body varsa metin alanların içerir
});
```
Sadece metin verilerini içeren bir multipart formu işlemek için .none() metodunu kullanabilirsiniz:
```javascript
const express = require("express");
const app = express();
const multer = require("multer");
const upload = multer();
app.post("/profile", upload.none(), function (req, res, next) {
// req.body metin alanlarını içerir
});
```
İşte multer'ın HTML formunda nasıl kullanıldığına dair bir örnek. `Enctype="multipart/form-data"` ve `name="uploaded_file"` alanlarına özellikle dikkat edin:
```html
```
Ardından JavaScript dosyanızda, hem dosyaya hem de body’ye erişmek için bu satırları eklemeniz gerekir. Upload fonksiyonunuzda formdaki `name` alanı değerini kullanmanız önemlidir. Bu, multer’a request içindeki hangi alanda dosya araması gerektiğini söyler. Eğer bu alanlar HTML formunda ve sunucuda aynı değilse, yükleme başarısız olur.
```javascript
const multer = require("multer");
const upload = multer({ dest: "./public/data/uploads/" });
app.post("/stats", upload.single("uploaded_file"), function (req, res) {
// req.file formdaki dosya, burada 'uploaded_file'
// req.body metin alanlarını içerir
console.log(req.file, req.body);
});
```
## API
### Dosya bilgisi
Her dosya aşağıdaki bilgileri içerir:
| Anahtar | Açıklama | Not |
| -------------- | -------------------------------------- | --------------- |
| `fieldname` | Formdaki alan adı | |
| `originalname` | Kullanıcının bilgisayarındaki dosya adı | |
| `encoding` | Dosyanın kodlama tipi | |
| `mimetype` | Dosyanın MIME tipi | |
| `size` | Dosyanın boyutu (byte) | |
| `destination` | Dosyanın 'destination' içindeki adı | `DiskStorage` |
| `filename` | Dosyanın klasör içindeki adı | `DiskStorage` |
| `path` | Yüklenen dosyanın tam yolu | `DiskStorage` |
| `buffer` | Dosyanın tamamını içeren `Buffer` | `MemoryStorage` |
### `multer(opts)`
Multer bir options (ayarlar) nesnesi kabul eder. En temel seçenek `dest` olup, dosyaların nereye yükleneceğini belirtir. Eğer options nesnesi verilmezse dosyalar bellekte tutulur ve diske yazılmaz.
Varsayılan olarak, ad çakışmalarını önlemek için Multer dosyaları yeniden adlandırır. Yeniden adlandırma fonksiyonu ihtiyacınıza göre özelleştirilebilir.
Multer’a geçirilebilecek seçenekler:
| Anahtar | Açıklama |
| ----------------- | ------------------------------------------------------ |
| `dest` veya `storage` | Dosyaların nereye kaydedileceği |
| `fileFilter` | Hangi dosyaların kabul edileceğini kontrol eden fonksiyon |
| `limits` | Yüklenen veri sınırları |
| `preservePath` | Sadece dosya adı yerine tam yolu saklar |
Ortalama bir web uygulamasında genellikle sadece `dest` gerekir:
```javascript
const upload = multer({ dest: "uploads/" });
```
Daha fazla kontrol için `storage` seçeneğini kullanabilirsiniz. `Multer`, `DiskStorage` ve `MemoryStorage` depolama motorları ile gelir; üçüncü taraf motorlar da mevcuttur.
#### `.single(fieldname)`
Tek bir dosya kabul eder ve `fieldname` ile eşleşen dosyayı `req.file` içine koyar.
#### `.array(fieldname[, maxCount])`
Birden fazla dosya kabul eder ve `fieldname` ile eşleşenleri `req.files` dizisine koyar. Opsiyonel olarak `maxCount`'tan fazla dosya yüklenirse hata verir.
#### `.fields(fields)`
Belirtilen alanlardan dosya kabul eder. fields bir nesne dizisi olup `req.files` içine koyulur.
`fields`, `name` ve isteğe bağlı olarak `maxCount` içeren nesnelerden oluşan bir dizi olmalıdır.
Örnek:
```javascript
[
{ name: "avatar", maxCount: 1 },
{ name: "gallery", maxCount: 8 },
];
```
#### `.none()`
Yalnızca metin alanlarını kabul eder. Herhangi bir dosya yüklenirse,
“LIMIT_UNEXPECTED_FILE” kodlu bir hata verir
#### `.any()`
Ağ üzerinden gelen tüm dosyaları kabul eder. Bir dizi dosya
`req.files` içinde saklanacaktır.
**UYARI:** Kullanıcıların yüklediği dosyaları her zaman kendiniz işlediğinizden emin olun.
Kötü niyetli bir kullanıcı, sizin öngörmediğiniz bir rotaya dosya yükleyebileceğinden, multer'ı asla global bir orta katman yazılımı olarak eklemeyin.
Bu işlevi yalnızca, yüklenen dosyaları işlediğiniz rotalarda kullanın.
### `storage`
#### `DiskStorage`
Disk depolama motoru, dosyaları diske kaydetme konusunda size tam kontrol sağlar.
```javascript
const storage = multer.diskStorage({
destination: function (req, file, cb) {
cb(null, "/tmp/my-uploads");
},
filename: function (req, file, cb) {
const uniqueSuffix = Date.now() + "-" + Math.round(Math.random() * 1e9);
cb(null, file.fieldname + "-" + uniqueSuffix);
},
});
const upload = multer({ storage: storage });
```
İki seçenek mevcuttur: `destination` ve `filename`. Her ikisi de
dosyanın nerede saklanacağını belirleyen işlevlerdir.
`destination`, yüklenen dosyaların hangi klasörde
saklanacağını belirlemek için kullanılır. Bu, `string` olarak da verilebilir (ör. `'/tmp/uploads'`). Eğer
`destination` verilmezse, işletim sisteminin geçici dosyalar için varsayılan
dizini kullanılır.
**Not:** `destination` işlevini kullanarak dizin oluşturmaktan siz
sorumlusunuz. Bir string aktardığınızda, multer dizin sizin için
oluşturulduğundan emin olacaktır.
`filename`, dosyanın klasör içinde nasıl adlandırılacağını belirlemek için kullanılır.
`filename` belirtilmezse, her dosyaya dosya uzantısı içermeyen rastgele bir ad verilir.
**Not:** Multer sizin için herhangi bir dosya uzantısı eklemez, işleviniz
dosya uzantısı ile birlikte tam bir dosya adı döndürmelidir.
Her fonksiyona, karar vermeyi kolaylaştırmak için hem istek (`req`) hem de dosya
hakkında bazı bilgiler (`file`) aktarılır.
`req.body`'nin henüz tam olarak doldurulmamış olabileceğini unutmayın. Bu,
istemcinin alanları ve dosyaları sunucuya aktarma sırasına bağlıdır.
Geri aramada kullanılan çağırma kuralını anlamak için (ilk parametre olarak null geçilmesi gerekir),
[Node.js hata işleme](https://web.archive.org/web/20220417042018/https://www.joyent.com/node-js/production/design/errors)
#### `MemoryStorage`
Bellek depolama motoru, dosyaları bellekte `Buffer` nesneleri olarak depolar.
Herhangi bir seçeneği yoktur.
```javascript
const storage = multer.memoryStorage();
const upload = multer({ storage: storage });
```
Bellek depolama kullanıldığında, dosya bilgileri tüm dosyayı içeren
`buffer` adlı bir alan içerir.
**UYARI**: Çok büyük dosyaları veya nispeten küçük dosyaları çok hızlı bir şekilde
çok sayıda yüklemek, bellek depolama kullanıldığında uygulamanızın bellek yetersizliği
sorununa neden olabilir.
### `limits`
Aşağıdaki isteğe bağlı özelliklerin boyut sınırlarını belirten bir nesne. Multer bu nesneyi doğrudan busboy'a aktarır ve özelliklerin ayrıntıları [busboy'un sayfasında](https://github.com/mscdex/busboy#busboy-methods) bulunabilir.
Kullanılabilir tamsayı değerleri şöyledir:
| Anahtar | Açıklama | Varsayılan |
| ---------------- | ------------------------------------------------------------------------ | ------------ |
| `fieldNameSize` | Maksimum alan adı boyutu | 100 bayt |
| `fieldSize` | Maksimum alan değeri boyutu (byte cinsinden) | 1MB |
| `fields` | Dosya olmayan alanların maksimum sayısı | Sonsuz |
| `fileSize` | Çok parçalı (multipart) formlar için maksimum dosya boyutu (bayt cinsinden) | Sonsuz |
| `files` | Çok parçalı (multipart) formlar için maksimum dosya alanı sayısı | Sonsuz |
| `parts` | Çok parçalı (multipart) formlar için toplam parça sayısı (alan + dosya) | Sonsuz |
| `headerPairs` | Çok parçalı (multipart) formlar için ayrıştırılacak maksimum header anahtar-değer çifti sayısı | 2000 |
Sınırları belirlemek, sitenizi hizmet reddi (DoS) saldırılarına karşı korumaya yardımcı olabilir.
### `fileFilter`
Yüklenecek ve atlanacak dosyaları kontrol etmek için bunu bir işleve ayarlayın.
İşlev şu şekilde olmalıdır:
```javascript
function fileFilter(req, file, cb) {
// Fonksiyon, dosyanın kabul edilip edilmeyeceğini belirtmek için
// boolean bir değerle `cb` fonksiyonunu çağırmalıdır.
// Bu dosyayı reddetmek için false döndürün:
cb(null, false);
// Dosyayı kabul etmek için true döndürün:
cb(null, true);
// Bir hata oluşursa her zaman bir hata da döndürebilirsiniz:
cb(new Error("Ne olduğunu bilmiyorum!"));
}
```
## Hata Yönetimi
Bir hatayla karşılaşıldığında, Multer hatayı Express'e devreder.
[Standart Express yöntemi](http://expressjs.com/guide/error-handling.html) kullanarak güzel bir hata sayfası görüntüleyebilirsiniz.
Özellikle Multer'dan gelen hataları yakalamak istiyorsanız,
orta katman işlevini kendiniz çağırabilirsiniz. Ayrıca, yalnızca [Multer hatalarını](https://github.com/expressjs/multer/blob/main/lib/multer-error.js) yakalamak istiyorsanız, `multer` nesnesine eklenmiş olan `MulterError` sınıfını kullanabilirsiniz (ör. `err instanceof multer.MulterError`).
```javascript
const multer = require("multer");
const upload = multer().single("avatar");
app.post("/profile", function (req, res) {
upload(req, res, function (err) {
if (err instanceof multer.MulterError) {
// Yükleme sırasında bir Multer hatası oluştu
} else if (err) {
// Yükleme sırasında bilinmeyen bir hata oluştu
}
// Her şey sorunsuz geçti.
});
});
```
## Özel depolama motoru
Kendi depolama motorunuzu nasıl oluşturacağınız hakkında bilgi için [Multer Depolama Motoru](https://github.com/expressjs/multer/blob/main/StorageEngine.md) bölümüne bakın.
## Lisans
[MIT](LICENSE)
[ci-image]: https://github.com/expressjs/multer/actions/workflows/ci.yml/badge.svg
[ci-url]: https://github.com/expressjs/multer/actions/workflows/ci.yml
[test-url]: https://coveralls.io/r/expressjs/multer?branch=main
[test-image]: https://badgen.net/coveralls/c/github/expressjs/multer/main
[npm-downloads-image]: https://badgen.net/npm/dm/multer
[npm-url]: https://npmjs.org/package/multer
[npm-version-image]: https://badgen.net/npm/v/multer
[ossf-scorecard-badge]: https://api.scorecard.dev/projects/github.com/expressjs/multer/badge
[ossf-scorecard-visualizer]: https://ossf.github.io/scorecard-visualizer/#/projects/github.com/expressjs/multer
expressjs-multer-2e2af08/doc/README-uz.md 0000664 0000000 0000000 00000031371 15213763722 0020154 0 ustar 00root root 0000000 0000000 # Multer [![NPM Version][npm-version-image]][npm-url] [![NPM Downloads][npm-downloads-image]][npm-url] [![Build Status][ci-image]][ci-url] [![Test Coverage][test-image]][test-url] [![OpenSSF Scorecard Badge][ossf-scorecard-badge]][ossf-scorecard-visualizer]
Multer - bu nodejs middleware bo'lib, asosan `multipart/form-data` shaklda yuborilgan fayllarni yuklashda ishlatiladi. Yuqori samaradorlikka erishish uchun [busboy](https://github.com/mscdex/busboy)ning ustiga yozilgan.
**Muhim**: Multer `multipart` bo'lmagan har qanday formani qayta ishlamaydi.
## Tarjimalar
Bu README boshqa tillarda ham mavjud:
- [العربية](https://github.com/expressjs/multer/blob/main/doc/README-ar.md) (arabcha)
- [English](https://github.com/expressjs/multer/blob/main/README.md) (inglizcha)
- [Español](https://github.com/expressjs/multer/blob/main/doc/README-es.md) (ispancha)
- [简体中文](https://github.com/expressjs/multer/blob/main/doc/README-zh-cn.md) (xitoycha)
- [한국어](https://github.com/expressjs/multer/blob/main/doc/README-ko.md) (korescha)
- [Português](https://github.com/expressjs/multer/blob/main/doc/README-pt-br.md) (portugalcha)
- [Русский язык](https://github.com/expressjs/multer/blob/main/doc/README-ru.md) (ruscha)
- [Français](https://github.com/expressjs/multer/blob/main/doc/README-fr.md) (fransuzcha)
## O'rnatish
```sh
$ npm install --save multer
```
## Foydalanish
Multer - `request` ob'ektiga `body` va `file` yoki `files` ob'ektini qo'shadi. `body` ob'ekti formaning matn maydonlarining (fields) qiymatlarini o'z ichiga oladi, `file` yoki `files` ob'ekti forma orqali yuklangan fayllarni o'z ichiga oladi.
Sodda ishlatish uchun namuna:
Formada `enctype="multipart/form-data"` qo'shish esdan chiqmasin
```html
```
```javascript
const express = require('express')
const multer = require('multer')
const upload = multer({ dest: 'uploads/' })
const app = express()
app.post('/profile', upload.single('avatar'), function (req, res, next) {
// req.file - fayl `avatar`
// req.body agar matnli maydonlar (fields) bo'lsa, ularni saqlanadi
})
app.post('/photos/upload', upload.array('photos', 12), function (req, res, next) {
// req.files - fayllar massivi `photos`
// req.body agar matnli maydonlar (fields) bo'lsa, ularni saqlanadi
})
const uploadMiddleware = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
app.post('/cool-profile', uploadMiddleware, function (req, res, next) {
// req.files - bu ob'ekt (String -> Array), matn maydoni(fieldname) - bu key, va qiymat - fayllar massivi
//
// misol:
// req.files['avatar'][0] -> File
// req.files['gallery'] -> Array
//
// req.body agar matnli maydonlar (fields) bo'lsa, ularni saqlanadi
})
```
Agarda siz faqat matndan iborat multipart form bilan ishlashingiz kerak bo'lsa, `.none()` ishlating:
```javascript
const express = require('express')
const app = express()
const multer = require('multer')
const upload = multer()
app.post('/profile', upload.none(), function (req, res, next) {
// req.body matnli maydonlar (fields)ni o'zida saqlaydi
})
```
## API
### Fayl haqida ma'lumot
Har bir fayl quyidagi ma'lumotlarni o'zida saqlaydi:
Kalit(key) | Ta'rif | Eslatma
--- |----------------------------------------| ---
`fieldname` | Formada berilgan maxsus nom |
`originalname` | Foydalanuvchi kompyuteridagi fayl nomi |
`encoding` | Faylning kodlash turi |
`mimetype` | Faylning `mime` turi |
`size` | Fayl hajmi - baytda |
`destination` | Fayl saqlangan papka | `DiskStorage`
`filename` | `destination`ni ichidagi fayl nomi | `DiskStorage`
`path` | Yuklangan faylning to'liq yo'li | `DiskStorage`
`buffer` | Butun boshli fayl `Buffer` tipda | `MemoryStorage`
### `multer(opts)`
Multer qo'shimcha ob'ekt qabul qiladi, ulardan eng asosiysi - `dest`,
Multerga fayllarni qayerga yuklash kerakligini aytadigan xususiyat. Agarda siz qo'shimcha(`options`) ob'ektni tashlab ketsangiz, fayllar xotirada saqlanadi va hech qachon diskka yozilmaydi.
Standart holatda - Multer nomlashda kelib chiqishi mumkin bo'lgan muammolarni oldini olish uchun fayllar nomini o'zgartiradi. O'z talablaringizga mos ravishda nomlash funksiyasini sozlay olashingiz mumkin.
Quyidagilar Multerga qo'shimcha qiymat sifati berilishi mumkin:
Kalit(key) | Ta'rif
--- | ---
`dest` yoki `storage` | Faylni qayerda saqlash
`fileFilter` | Qaysi fayllar qabul qilinishini boshqarish funksiyasi
`limits` | Yuklash chegarasi
`preservePath` | Asosiy nom o'rniga fayllarning to'liq yo'lini saqlash
`defParamCharset` | Kengaytirilgan parametrlar bo'lmagan qism sarlavha parametrlari qiymatlari (masalan, fayl nomi) uchun ishlatish uchun standart belgilar to'plami (aniq belgilar to'plamini o'z ichiga olmaydi). Standart: `'latin1'`
O'rtacha veb-ilovada faqat `dest` kerak bo'lishi mumkin va quyidagicha sozlanishi mumkin
```javascript
const upload = multer({ dest: 'uploads/' })
```
Yuklamalaringizni boshqarishda ko'proq nazoratni xohlasangiz, `dest` o'rniga `storage` tanlovini ishlatishingiz kerak. Multer `DiskStorage` va `MemoryStorage` saqlash motorlari(engines) bilan keladi. Boshqa motorlar(engines) uchun uchinchi tomondan(third parties) ko'proq tanlovlar keladi.
#### `.single(fieldname)`
`fieldname` nomi bilan yagona faylni qabul qiladi. Yagona fayl `req.file` da saqlanadi.
#### `.array(fieldname[, maxCount])`
`fieldname` nomi bilan fayllar massivini qabul qiladi. Agar `maxCount` dan ko'p fayl yuklash urinishi bo'lsa, hatolikni aniqlash imkoniyatini berish mumkin. Fayllar massivi `req.files` da saqlanadi.
#### `.fields(fields)`
`fields`da aniqlangan fayllarni qabul qiladi. Fayllar massivini saqlash uchun `req.files` ichidagi massivda saqlanadi.
`fields` ob'ektida `name` va `maxCount` kalitlar(keys)ni o'z ichiga olishi kerak. Misol:
```javascript
[
{ name: 'avatar', maxCount: 1 },
{ name: 'gallery', maxCount: 8 }
]
```
#### `.none()`
Faqatgina matnli maydonlar(fields)ni oladi. Agarda biror fayl yuklansa, "LIMIT\_UNEXPECTED\_FILE" xatoligi yuboriladi.
#### `.any()`
Ushbu so'rov barcha fayllarni qabul qiladi, fayllar `req.files` ichida saqlanadi.
**OGOHLANTIRISH:** Foydalanuvchi yuklagan fayllarni doimo boshqarib turishni unutmang. Ularni boshqa yo'l(route)ni kutmagan holda fayllarini yuklash imkonini beradigan global middleware sifatida multerni sozlamang. Faqatgina yuklangan fayllarni boshqarish kerak bo'lgan yo'l(route)larda ushbu funksiyani ishlating.
### `storage`
#### `DiskStorage`
Diskka saqlash motori(engine) sizga fayllarni saqlashda to'liq nazorat qilish imkonini beradi.
```javascript
const storage = multer.diskStorage({
destination: function (req, file, cb) {
cb(null, '/tmp/my-uploads')
},
filename: function (req, file, cb) {
cb(null, file.fieldname + '-' + Date.now())
}
})
const upload = multer({ storage: storage })
```
`destination` va `filename` qo'shimcha tanlovlari mavjud, ular ikkala ham qaysi papkada faylni saqlash kerakligini aniqlab turadigan funksiyalardir.
`destination` yuklangan fayllarni qaysi papkada saqlash kerakligini aniqlab turadi. Bu, `string` sifatida berilishi mumkin (masalan, `'/tmp/uploads'`). Agar `destination` berilmagan bo'lsa, operatsion tizimning vaqtinchalik fayllar uchun ishlatiladigan papkasini ishlatadi.
**Diqqat:** `destination` ni funksiya sifatida berib bo'lganda papka ochilganligiga o'zingiz javobgar bo'lasiz. Agar `string` sifatida bersangiz, multer papkani o'zi uchun yaratishni ta'minlaydi.
`filename` faylni papka ichida qanday nomlanganligini aniqlaydi. Agar `filename` berilmagan bo'lsa, har bir faylga fayl kengaytmasini o'z ichiga olmagan tasodifiy nom beriladi.
**Diqqat:** Multer siz uchun fayl kengaytmasini qo'shmaydi, sizning funksiyangiz kengaytma bilan to'liq nomni qaytarishi kerak.
Har bir funksiya `req` so'rovini va fayl haqida ma'lumotlarni (`file`) olish uchun o'tkaziladi.
Diqqat qiling, `req.body` hali to'liq to'ldirilmagan bo'lishi mumkin. Bu mijozning maydon(field)larni va fayllarni serverga qanday yuborishiga bog'liq bo'ladi.
Callback funktsiyasida ishlatiladigan chaqirish tartibini tushunish uchun (birinchi parametr sifatida null o‘tkazish talab etilishi) ko‘rish uchun quyidagi manzilga murojaat qiling:
[Node.js da xatoliklarni ushlash](https://web.archive.org/web/20220417042018/https://www.joyent.com/node-js/production/design/errors)
#### `MemoryStorage`
Xotira saqlash motori fayllarni xotirada `Buffer` ob'ektlar sifatida saqlaydi. Uning qo'shimcha qiymatlari yo‘q.
```javascript
const storage = multer.memoryStorage()
const upload = multer({ storage: storage })
```
Xotirada saqlash paytida, fayl ma'lumotlari `buffer` deb nomlanadigan maydonni o‘z ichiga oladi.
**DIQQAT:** Juda katta fayllarni yuklash, yoki kichik fayllarni tez-tez yuklash, xotirada saqlash ishlatilganda, sizning ilovangizning xotirasini to'ldirib qo'yishi mumkin.
### `limits`
Quyidagi xususiyatlar o'lchov(limit)larni aniqlaydigan obyekt. Multer ushbu obyektni to'g'ridan-to'g'ri busboy ga o'tkazadi va xususiyatlar tafsilotlari [busboy sahifasida](https://github.com/mscdex/busboy#busboy-methods)dan topishingiz mumkin.
Quyidagi butun qiymatlar mavjud:
Kalit(key) | Ta'rif | Odatiy qiymat
--- |---------------------------------------------------------------------------------------------| ---
`fieldNameSize` | Maksimal maydon nomi o'lchami | 100 bayt
`fieldSize` | Maksimal maydon qiymati o'lchami (baytlarda) | 1MB
`fields` | Fayl bo'lmagan maydonlarning maksimal soni | Cheklanmagan
`fileSize` | Multipart form uchun faylning maksimal o'lchami (baytda) | Cheklanmagan
`files` | Multipart form uchun fayllar sonining maksimal chegarasi | Cheklanmagan
`parts` | Multipart form uchun fayllar sonining maksimal chegarasi (fieldlar va fayllar) | Cheklanmagan
`headerPairs` | Multipart form uchun ma'lumotlar (kalit va qiymat juftliklari) sonining maksimal chegarasi | 2000
Chegaralarni sozlash, DoS-hujumlariga qarshi saytingizni himoya qilishga yordam bera olishi mumkin
### `fileFilter`
Bu, qaysi fayllarni yuklashi, qaysilarini o'tkazib yuborish kerakligini boshqarish uchun funksiya sifatida sozlasa bo'ladi. Funksiya quyidagi ko'rinishda bo'lishi kerak:"
```javascript
function fileFilter (req, file, cb) {
// Bu funksiya, faylni qabul qilish kerakligini anglatish uchun `cb` ni
// boolean qiymat bilan chaqirish kerak.
// Faylni qabul qilishni rad etish uchun false quyudagicha berilishi kerak:
cb(null, false)
// Faylni qabul qiilishni tasdiqlash uchun true quyudagicha berilishi kerak:
cb(null, true)
// Nimadir xato ketsa, siz har doim Error berishingiz mumkin:
cb(new Error('I don\'t have a clue!'))
}
```
## Xatolar bilan ishlash
Xatoga duch kelganda, Multer xatoni Expressga yuboradi. [standart express usuli](http://expressjs.com/guide/error-handling.html)dan foydalanib xatoni tartibliroq chiqarishingiz mumkin.
Agar siz Multerdan chiqqan xatolarni aniqlamoqchi bo'lsangiz o'zingiz `middleware` funksiya yozishingiz mumkin. Shuningdek, agar siz faqat [Multer xatolarini](https://github.com/expressjs/multer/blob/main/lib/multer-error.js) ushlamoqchi bo'lsangiz, siz `multer` ob'ektiga yozilgan `MulterError` class ni ishlatishingiz mumkin (masalan, `err instanceof multer.MulterError`).
```javascript
const multer = require('multer')
const upload = multer().single('avatar')
app.post('/profile', function (req, res) {
upload(req, res, function (err) {
if (err instanceof multer.MulterError) {
// Yuklanishda Multerdan xatolik yuz berganda.
} else {
// Yuklanishda noma'lum xatolik yuz berganda.
}
// Hammasi muvaffaqqiyatli bo'lganda.
})
})
```
## Maxsus saqlash mexanizmi
O'zingizning saqlash dvigatelingizni qanday yaratish haqida ma'lumot olish: [Maxsus saqlash mexanizmi](https://github.com/expressjs/multer/blob/main/StorageEngine.md).
## Litsenziya
[MIT](LICENSE)
[ci-image]: https://github.com/expressjs/multer/actions/workflows/ci.yml/badge.svg
[ci-url]: https://github.com/expressjs/multer/actions/workflows/ci.yml
[test-url]: https://coveralls.io/r/expressjs/multer?branch=main
[test-image]: https://badgen.net/coveralls/c/github/expressjs/multer/main
[npm-downloads-image]: https://badgen.net/npm/dm/multer
[npm-url]: https://npmjs.org/package/multer
[npm-version-image]: https://badgen.net/npm/v/multer
[ossf-scorecard-badge]: https://api.scorecard.dev/projects/github.com/expressjs/multer/badge
[ossf-scorecard-visualizer]: https://ossf.github.io/scorecard-visualizer/#/projects/github.com/expressjs/multer
expressjs-multer-2e2af08/doc/README-vi.md 0000664 0000000 0000000 00000032610 15213763722 0020131 0 ustar 00root root 0000000 0000000 # Multer [![NPM Version][npm-version-image]][npm-url] [![NPM Downloads][npm-downloads-image]][npm-url] [![Build Status][ci-image]][ci-url] [![Test Coverage][test-image]][test-url] [![OpenSSF Scorecard Badge][ossf-scorecard-badge]][ossf-scorecard-visualizer]
Multer là thư viện trung gian hỗ trợ việc xử lý `multipart/form-data`, mục đích chính cho việc upload file. Thư viện này dựa trên [busboy](https://github.com/mscdex/busboy) để hiệu quả hơn.
**CHÚ Ý**: Multer sẽ không xử lý bất kỳ form nào ngoài multipart (`multipart/form-data`).
## Dịch:
Các bạn có thể đọc ở các bản dịch ngôn ngữ khác:
- [English](https://github.com/expressjs/multer/blob/main/README.md) (Tiếng Anh)
- [简体中文](https://github.com/expressjs/multer/blob/main/doc/README-zh-cn.md) (Chinese)
- [한국어](https://github.com/expressjs/multer/blob/main/doc/README-ko.md) (Korean)
- [Русский язык](https://github.com/expressjs/multer/blob/main/doc/README-ru.md) (Russian)
## Cài đặt
```sh
$ npm install --save multer
```
## Sử dụng
Multer gắn thêm một object `body` và một object `file` (hoặc `files` trường hợp upload nhiều file) vào object `request`. Object `body` này sẽ chứa các biến text của form, còn object `file` (hoặc `files`) sẽ chứa các file được upload qua form.
Cách sử sụng:
Phải thêm `enctype="multipart/form-data"` vào form của bạn.
```html
```
```javascript
var express = require('express');
var multer = require('multer');
var upload = multer({ dest: 'uploads/' });
var app = express();
app.post('/profile', upload.single('avatar'), function(req, res, next) {
// req.file là 1 file `avatar` được upload
// req.body sẽ giữ thông tin gắn kèm (vd: text fields), nếu có
});
app.post('/photos/upload', upload.array('photos', 12), function(
req,
res,
next
) {
// req.files là một mảng của các file `photos`
// req.body sẽ giữ thông tin gắn kèm (vd: text fields), nếu có
});
var uploadMiddleware = upload.fields([
{ name: 'avatar', maxCount: 1 },
{ name: 'gallery', maxCount: 8 },
]);
app.post('/cool-profile', uploadMiddleware, function(req, res, next) {
// req.files là một object kiểu (String -> Array) mà fieldname là key, và value là mảng các files
//
// vd:
// req.files['avatar'][0] -> File
// req.files['gallery'] -> Array
//
// req.body sẽ giữ thông tin gắn kèm (vd: text fields), nếu có
});
```
Trong trường hợp bạn cần xử lý một multipart form chỉ chứa text, bạn nên sử dụng hàm `.none()`:
```javascript
var express = require('express');
var app = express();
var multer = require('multer');
var upload = multer();
app.post('/profile', upload.none(), function(req, res, next) {
// req.body sẽ giữ thông tin gắn kèm (vd: text fields)
});
```
## API
### Thông tin File được upload
Mỗi file sẽ chứa các thông tin sau:
| Thuộc tính | Mô tả | Ghi chú |
| -------------- | --------------------------------------------------------------- | ------------------------- |
| `fieldname` | tên mỗi thuộc tính ở trong form |
| `originalname` | Tên của file nằm trên máy của người dùng, trước khi được upload |
| `encoding` | Kiểu Encoding của file |
| `mimetype` | Mime type của file | `image/jpeg`, `image/png` |
| `size` | Kích thước của file (theo bytes) |
| `destination` | Đường dẫn tới thư mục file được lưu | `DiskStorage` |
| `filename` | Tên của file (ở trong `destination`) | `DiskStorage` |
| `path` | Đường dẫn đầy đủ tới file đã upload | `DiskStorage` |
| `buffer` | Một `Buffer` của toàn bộ file | `MemoryStorage` |
### Tham số `multer(opts)`
Multer chấp nhận một biến options. Cơ bản là thuộc tính `dest`, là nơi sẽ lưu
file được upload. Trong trường hợp bỏ qua options này, file sẽ được giữ trong
RAM và không được lưu trên ổ cứng.
Mặc định, Multer sẽ đổi tên các file, vì vậy để tránh bị trùng lặp, bạn có thể
tùy biến hàm đổi tên này.
Dưới đây là các tùy chọn mà bạn có thể sử dụng:
| Thuộc tính | Mô tả |
| --------------------- | -------------------------------------------------- |
| `dest` hoặc `storage` | Nơi lưu trữ file |
| `fileFilter` | Hàm để xử lý chỉ những file nào mới được chấp nhận |
| `limits` | Giới hạn dung lượng file được upload |
| `preservePath` | Giữ đầy đủ đường dẫn tới file thay vì chỉ tên file |
| `defParamCharset` | Bộ ký tự mặc định để sử dụng cho các giá trị tham số tiêu đề phần (ví dụ: tên tệp) không phải là tham số mở rộng (không chứa bộ ký tự rõ ràng). Mặc định: `'latin1'` |
Nói chung với web app, chỉ `dest` mới cần khai báo, như bên dưới:
```javascript
var upload = multer({ dest: 'uploads/' });
```
Nếu bạn muốn tùy biến việc upload, bạn sẽ muốn dùng tùy chọn `storage` thay vì `dest`.
Multer sẽ sử dụng 1 trong 2 cách `DiskStorage` và `MemoryStorage`; Hoặc các cách khác (với các thư viện ngoài).
#### `.single(fieldname)`
Chấp nhận chỉ một file với tên thuộc tính `fieldname`. File này truy cập qua `req.file`.
#### `.array(fieldname[, maxCount])`
Chấp nhận mảng các file, tất cả đều với tên `fieldname`. Một lỗi sẽ bắn ra nếu có
nhiều hơn `maxCount` file được upload. Các file này được lưu ở `req.files`.
#### `.fields(fields)`
Chấp nhận nhiều file với thuộc tính `fields`. Một object với mảng các file được lưu ở `req.files`.
`fields` là một mảng các object với thuộc tính `name` và có thể có thuộc tính `maxCount` hoặc không.
Ví dụ:
```javascript
[{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }];
```
#### `.none()`
Chỉ chấp nhận các giá trị text trong form. Nếu bất kỳ file được đính
kèm, một lỗi với mã "LIMIT_UNEXPECTED_FILE" sẽ bắn ra.
#### `.any()`
Chấp nhận tất cả file đến từ bất kỳ nguồn nào. Một mảng các file sẽ được lưu
ở `req.files`.
**CHÚ Ý:** Hãy chắc chắn bạn không bỏ qua bất kỳ file nào mà người dùng upload.
Đừng bao giờ khai báo Multer như một middleware toàn cục, vì người dùng có thể upload
các file tới một api nào đó mà bạn không biết. Chỉ sử dụng hàm này ở trên api mà bạn
muốn xử lý việc upload file.
### `storage`
#### `DiskStorage`
Cơ chế lưu trữ trên ổ đĩa cho phép bạn có đầy đủ quyền để thao tác với file.
```javascript
var storage = multer.diskStorage({
destination: function(req, file, cb) {
cb(null, '/tmp/my-uploads');
},
filename: function(req, file, cb) {
cb(null, file.fieldname + '-' + Date.now());
},
});
var upload = multer({ storage: storage });
```
Có 2 tùy chọn, `destination` và `filename`. Chúng đều dùng để xác định nơi nào
file sẽ được lưu trữ.
`destination` được dùng để xác định thư mục nào file được upload. Có thể là một
`string` (vd: `'/tmp/uploads'`). Nếu không khai báo `destination`, thư mục tạm
(của hệ điều hành) sẽ được dùng để chứa các file đó.
**Ghi chú:** Nếu bạn khai báo `destination` là một hàm, bạn phải tự tạo đường
dẫn. Còn nếu truyền vào một string, multer sẽ đảm bảo việc tạo đường dẫn đó cho bạn.
`filename` được dùng để xác định file nào sẽ được lưu trong thư mục. Nếu không
có `filename` nào, mỗi file sẽ nhận tên ngẫu nhiên mà không bao gồm đuôi của file.
**Ghi chú:** Multer sẽ không thêm bất kỳ đuôi file nào cho bạn, hàm của bạn nên
trả về một file với đuôi của nó.
Mỗi hàm được truyền cả ở request (`req`) và thông tin về file (`file`) để xử lý.
Chú ý `req.body` có thể không chứa đầy đủ thông tin, phụ thuộc việc thứ tự các
trường dữ liệu và file được gửi tới server lúc nào.
#### `MemoryStorage`
Memory storage lưu các file ở bộ nhớ máy dưới dạng một object `Buffer`. Nó không
có bất kỳ tùy chọn nào.
```javascript
var storage = multer.memoryStorage();
var upload = multer({ storage: storage });
```
Khi sử dụng memory storage, thông tin file sẽ chứa một trường `buffer`, trường
này chứa toàn bộ file.
**CHÚ Ý**: Việc upload file rất lớn, hoặc tương tự việc nhiều file nhỏ, có thể
gây ra tràn bộ nhớ khi memory storage được sử dụng.
### `limits`
Một object mô tả giới hạn kích thước trong thuộc tính nên được sử dụng. Multer truyền object này trực tiếp vào busboy, và chi tiết của busboy có thể xem thêm ở [busboy's page](https://github.com/mscdex/busboy#busboy-methods).
Các số dưới dây cũng có thể được dùng:
| Thuộc tính | Mô tả | Giá trị mặc định |
| --------------- | -------------------------------------------------------------------- | ---------------- |
| `fieldNameSize` | Độ dài tối đa của tên field | 100 bytes |
| `fieldSize` | Kích thước tối đa của mỗi field (theo bytes) | 1MB |
| `fields` | Số lượng tối đa của các fields không phải là file | Infinity |
| `fileSize` | Cho multipart forms, kích thước tối đa của file (theo bytes) | Infinity |
| `files` | Cho multipart forms, số lượng file tối đa | Infinity |
| `parts` | Cho multipart forms, số lượng tối đa của parts (gồm fields + files) | Infinity |
| `headerPairs` | Cho multipart forms, số tối đa trong header cặp key=>value để truyền | 2000 |
Khai báo các giới hạn này giúp cho site của bạn chống lại các tấn công nguy hiểm (DoS).
### `fileFilter`
Dùng hàm này để xử lý các file nào cho phép và bị bỏ qua. Xem ví dụ dưới dây:
```javascript
function fileFilter(req, file, cb) {
// hàm này sẽ gọi callback `cb` với 1 biến boolean
// để chỉ ra rằng file có được chấp nhận hay không
// Để chặn file này, truyền `false` như sau:
cb(null, false);
// Để chấp nhận file này, truỳen `true`, như sau:
cb(null, true);
// Hoặc bạn có thể truyền vào 1 lỗi nếu có vấn đề xảy ra:
cb(new Error("I don't have a clue!"));
}
```
## Error handling
Khi một lỗi xảy ra, Multer sẽ gửi lỗi đó cho Express. Bạn có thể hiển thị
đẹp hơn sử dụng [cách bắt lỗi chuẩn của Express](http://expressjs.com/guide/error-handling.html).
Nếu bạn muốn bắt các lỗi cụ thể từ Multer, bạn có thể tự gọi hàm trung gian (middleware) này. Ngoài ra, nếu bạn chỉ muốn bắt [lỗi của Multer](https://github.com/expressjs/multer/blob/main/lib/multer-error.js), bạn có thể dùng class `MulterError` được đính kèm với chính object `multer` (vd: `err instanceof multer.MulterError`).
```javascript
var multer = require('multer');
var upload = multer().single('avatar');
app.post('/profile', function(req, res) {
upload(req, res, function(err) {
if (err instanceof multer.MulterError) {
// Một lỗi của Multer xảy ra khi upload.
} else if (err) {
// Một lỗi không xác định xảy ra khi upload.
}
// Mọi thứ khác chạy ok.
});
});
```
## Tùy chọn storage engine
Để làm sao tự xây dựng cơ chế lưu file riêng của mình, hãy xem [Multer Storage Engine](https://github.com/expressjs/multer/blob/main/StorageEngine.md).
## License
[MIT](LICENSE)
[ci-image]: https://github.com/expressjs/multer/actions/workflows/ci.yml/badge.svg
[ci-url]: https://github.com/expressjs/multer/actions/workflows/ci.yml
[test-url]: https://coveralls.io/r/expressjs/multer?branch=main
[test-image]: https://badgen.net/coveralls/c/github/expressjs/multer/main
[npm-downloads-image]: https://badgen.net/npm/dm/multer
[npm-url]: https://npmjs.org/package/multer
[npm-version-image]: https://badgen.net/npm/v/multer
[ossf-scorecard-badge]: https://api.scorecard.dev/projects/github.com/expressjs/multer/badge
[ossf-scorecard-visualizer]: https://ossf.github.io/scorecard-visualizer/#/projects/github.com/expressjs/multer
expressjs-multer-2e2af08/doc/README-zh-cn.md 0000664 0000000 0000000 00000024646 15213763722 0020544 0 ustar 00root root 0000000 0000000 **此文档于2016年10月3日翻译时multer的版本是1.2.0，它可能不是最新的！**
**甚至可能存在翻译错误！你可能需要阅读原版英语[README](../README.md)**
**此文档仅供参考！**
# Multer [![NPM Version][npm-version-image]][npm-url] [![NPM Downloads][npm-downloads-image]][npm-url] [![Build Status][ci-image]][ci-url] [![Test Coverage][test-image]][test-url] [![OpenSSF Scorecard Badge][ossf-scorecard-badge]][ossf-scorecard-visualizer]
Multer 是一个 node.js 中间件，用于处理 `multipart/form-data` 类型的表单数据，它主要用于上传文件。它是写在 [busboy](https://github.com/mscdex/busboy) 之上非常高效。
**注意**: Multer 不会处理任何非 `multipart/form-data` 类型的表单数据。
## 其它语言
- [العربية](https://github.com/expressjs/multer/blob/main/doc/README-ar.md) (阿拉伯语)
- [English](https://github.com/expressjs/multer/blob/main/README.md) (英语)
- [Español](https://github.com/expressjs/multer/blob/main/doc/README-es.md) (西班牙文)
- [한국어](https://github.com/expressjs/multer/blob/main/doc/README-ko.md) (朝鲜语)
- [Русский язык](https://github.com/expressjs/multer/blob/main/doc/README-ru.md) (俄語)
- [Português](https://github.com/expressjs/multer/blob/main/doc/README-pt-br.md) (巴西葡萄牙语)
## 安装
```sh
$ npm install --save multer
```
## 使用
Multer 会添加一个 `body` 对象 以及 `file` 或 `files` 对象 到 express 的 `request` 对象中。
`body` 对象包含表单的文本域信息，`file` 或 `files` 对象包含对象表单上传的文件信息。
基本使用方法:
```javascript
const express = require('express')
const multer = require('multer')
const upload = multer({ dest: 'uploads/' })
const app = express()
app.post('/profile', upload.single('avatar'), function (req, res, next) {
// req.file 是 `avatar` 文件的信息
// req.body 将具有文本域数据，如果存在的话
})
app.post('/photos/upload', upload.array('photos', 12), function (req, res, next) {
// req.files 是 `photos` 文件数组的信息
// req.body 将具有文本域数据，如果存在的话
})
const uploadMiddleware = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
app.post('/cool-profile', uploadMiddleware, function (req, res, next) {
// req.files 是一个对象 (String -> Array) 键是文件名，值是文件数组
//
// 例如：
// req.files['avatar'][0] -> File
// req.files['gallery'] -> Array
//
// req.body 将具有文本域数据，如果存在的话
})
```
如果你需要处理一个只有文本域的表单，你应当使用 `.none()`:
```javascript
const express = require('express')
const app = express()
const multer = require('multer')
const upload = multer()
app.post('/profile', upload.none(), function (req, res, next) {
// req.body 包含文本域
})
```
## API
### 文件信息
每个文件具有下面的信息:
Key | Description | Note
--- | --- | ---
`fieldname` | Field name 由表单指定 |
`originalname` | 用户计算机上的文件的名称 |
`encoding` | 文件编码 |
`mimetype` | 文件的 MIME 类型 |
`size` | 文件大小（字节单位） |
`destination` | 保存路径 | `DiskStorage`
`filename` | 保存在 `destination` 中的文件名 | `DiskStorage`
`path` | 已上传文件的完整路径 | `DiskStorage`
`buffer` | 一个存放了整个文件的 `Buffer` | `MemoryStorage`
### `multer(opts)`
Multer 接受一个 options 对象，其中最基本的是 `dest` 属性，这将告诉 Multer 将上传文件保存在哪。如果你省略 options 对象，这些文件将保存在内存中，永远不会写入磁盘。
为了避免命名冲突，Multer 会修改上传的文件名。这个重命名功能可以根据您的需要定制。
以下是可以传递给 Multer 的选项。
Key | Description
--- | ---
`dest` or `storage` | 在哪里存储文件
`fileFilter` | 文件过滤器，控制哪些文件可以被接受
`limits` | 限制上传的数据
`preservePath` | 保存包含文件名的完整文件路径
`defParamCharset` | 用于部分标头参数值（例如文件名）的默认字符集，这些参数不是扩展参数（不包含显式字符集）。默认值：`'latin1'`
通常，一般的网页应用，只需要设置 `dest` 属性，像这样：
```javascript
const upload = multer({ dest: 'uploads/' })
```
如果你想在上传时进行更多的控制，你可以使用 `storage` 选项替代 `dest`。Multer 具有 `DiskStorage` 和 `MemoryStorage` 两个存储引擎；另外还可以从第三方获得更多可用的引擎。
#### `.single(fieldname)`
接受一个以 `fieldname` 命名的文件。这个文件的信息保存在 `req.file`。
#### `.array(fieldname[, maxCount])`
接受一个以 `fieldname` 命名的文件数组。可以配置 `maxCount` 来限制上传的最大数量。这些文件的信息保存在 `req.files`。
#### `.fields(fields)`
接受指定 `fields` 的混合文件。这些文件的信息保存在 `req.files`。
`fields` 应该是一个对象数组，应该具有 `name` 和可选的 `maxCount` 属性。
Example:
```javascript
[
{ name: 'avatar', maxCount: 1 },
{ name: 'gallery', maxCount: 8 }
]
```
#### `.none()`
只接受文本域。如果任何文件上传到这个模式，将发生 "LIMIT\_UNEXPECTED\_FILE" 错误。这和 `upload.fields([])` 的效果一样。
#### `.any()`
接受一切上传的文件。文件数组将保存在 `req.files`。
**警告:** 确保你总是处理了用户的文件上传。
永远不要将 multer 作为全局中间件使用，因为恶意用户可以上传文件到一个你没有预料到的路由，应该只在你需要处理上传文件的路由上使用。
### `storage`
#### 磁盘存储引擎 (`DiskStorage`)
磁盘存储引擎可以让你控制文件的存储。
```javascript
const storage = multer.diskStorage({
destination: function (req, file, cb) {
cb(null, '/tmp/my-uploads')
},
filename: function (req, file, cb) {
cb(null, file.fieldname + '-' + Date.now())
}
})
const upload = multer({ storage: storage })
```
有两个选项可用，`destination` 和 `filename`。他们都是用来确定文件存储位置的函数。
`destination` 是用来确定上传的文件应该存储在哪个文件夹中。也可以提供一个 `string` (例如 `'/tmp/uploads'`)。如果没有设置 `destination`，则使用操作系统默认的临时文件夹。
**注意:** 如果你提供的 `destination` 是一个函数，你需要负责创建文件夹。当提供一个字符串，multer 将确保这个文件夹是你创建的。
`filename` 用于确定文件夹中的文件名的确定。 如果没有设置 `filename`，每个文件将设置为一个随机文件名，并且是没有扩展名的。
**注意:** Multer 不会为你添加任何扩展名，你的程序应该返回一个完整的文件名。
每个函数都传递了请求对象 (`req`) 和一些关于这个文件的信息 (`file`)，有助于你的决定。
注意 `req.body` 可能还没有完全填充，这取决于向客户端发送字段和文件到服务器的顺序。
#### 内存存储引擎 (`MemoryStorage`)
内存存储引擎将文件存储在内存中的 `Buffer` 对象，它没有任何选项。
```javascript
const storage = multer.memoryStorage()
const upload = multer({ storage: storage })
```
当使用内存存储引擎，文件信息将包含一个 `buffer` 字段，里面包含了整个文件数据。
**警告**: 当你使用内存存储，上传非常大的文件，或者非常多的小文件，会导致你的应用程序内存溢出。
### `limits`
一个对象，指定一些数据大小的限制。Multer 通过这个对象使用 busboy，详细的特性可以在 [busboy's page](https://github.com/mscdex/busboy#busboy-methods) 找到。
可以使用下面这些:
Key | Description | Default
--- | --- | ---
`fieldNameSize` | field 名字最大长度 | 100 bytes
`fieldSize` | field 值的最大长度 | 1MB
`fields` | 非文件 field 的最大数量 | 无限
`fileSize` | 在 multipart 表单中，文件最大长度 (字节单位) | 无限
`files` | 在 multipart 表单中，文件最大数量 | 无限
`parts` | 在 multipart 表单中，part 传输的最大数量(fields + files) | 无限
`headerPairs` | 在 multipart 表单中，键值对最大组数 | 2000
设置 limits 可以帮助保护你的站点抵御拒绝服务 (DoS) 攻击。
### `fileFilter`
设置一个函数来控制什么文件可以上传以及什么文件应该跳过，这个函数应该看起来像这样：
```javascript
function fileFilter (req, file, cb) {
// 这个函数应该调用 `cb` 用boolean值来
// 指示是否应接受该文件
// 拒绝这个文件，使用`false`，像这样:
cb(null, false)
// 接受这个文件，使用`true`，像这样:
cb(null, true)
// 如果有问题，你可以总是这样发送一个错误:
cb(new Error('I don\'t have a clue!'))
}
```
## 错误处理机制
当遇到一个错误，multer 将会把错误发送给 express。你可以使用一个比较好的错误展示页 ([express标准方式](http://expressjs.com/guide/error-handling.html))。
如果你想捕捉 multer 发出的错误，你可以自己调用中间件程序。如果你想捕捉 [Multer 错误](https://github.com/expressjs/multer/blob/main/lib/multer-error.js)，你可以使用 `multer` 对象下的 `MulterError` 类 (即 `err instanceof multer.MulterError`)。
```javascript
const multer = require('multer')
const upload = multer().single('avatar')
app.post('/profile', function (req, res) {
upload(req, res, function (err) {
if (err instanceof multer.MulterError) {
// 发生错误
} else if (err) {
// 发生错误
}
// 一切都好
})
})
```
## 定制存储引擎
如果你想要构建自己的存储引擎，请看 [这里](/StorageEngine.md) 。
## License
[MIT](LICENSE)
[ci-image]: https://github.com/expressjs/multer/actions/workflows/ci.yml/badge.svg
[ci-url]: https://github.com/expressjs/multer/actions/workflows/ci.yml
[test-url]: https://coveralls.io/r/expressjs/multer?branch=main
[test-image]: https://badgen.net/coveralls/c/github/expressjs/multer/main
[npm-downloads-image]: https://badgen.net/npm/dm/multer
[npm-url]: https://npmjs.org/package/multer
[npm-version-image]: https://badgen.net/npm/v/multer
[ossf-scorecard-badge]: https://api.scorecard.dev/projects/github.com/expressjs/multer/badge
[ossf-scorecard-visualizer]: https://ossf.github.io/scorecard-visualizer/#/projects/github.com/expressjs/multer
expressjs-multer-2e2af08/index.js 0000664 0000000 0000000 00000005271 15213763722 0017141 0 ustar 00root root 0000000 0000000 var makeMiddleware = require('./lib/make-middleware')
var diskStorage = require('./storage/disk')
var memoryStorage = require('./storage/memory')
var MulterError = require('./lib/multer-error')
function allowAll (req, file, cb) {
cb(null, true)
}
function Multer (options) {
if (options.storage) {
this.storage = options.storage
} else if (options.dest) {
this.storage = diskStorage({ destination: options.dest })
} else {
this.storage = memoryStorage()
}
this.limits = options.limits
this.preservePath = options.preservePath
this.defParamCharset = options.defParamCharset || 'latin1'
this.fileFilter = options.fileFilter || allowAll
}
Multer.prototype._makeMiddleware = function (fields, fileStrategy) {
function setup () {
var fileFilter = this.fileFilter
var filesLeft = Object.create(null)
fields.forEach(function (field) {
if (typeof field.maxCount === 'number') {
filesLeft[field.name] = field.maxCount
} else {
filesLeft[field.name] = Infinity
}
})
function wrappedFileFilter (req, file, cb) {
if ((filesLeft[file.fieldname] || 0) <= 0) {
return cb(new MulterError('LIMIT_UNEXPECTED_FILE', file.fieldname))
}
filesLeft[file.fieldname] -= 1
fileFilter(req, file, cb)
}
return {
limits: this.limits,
preservePath: this.preservePath,
defParamCharset: this.defParamCharset,
storage: this.storage,
fileFilter: wrappedFileFilter,
fileStrategy: fileStrategy
}
}
return makeMiddleware(setup.bind(this))
}
Multer.prototype.single = function (name) {
return this._makeMiddleware([{ name: name, maxCount: 1 }], 'VALUE')
}
Multer.prototype.array = function (name, maxCount) {
return this._makeMiddleware([{ name: name, maxCount: maxCount }], 'ARRAY')
}
Multer.prototype.fields = function (fields) {
return this._makeMiddleware(fields, 'OBJECT')
}
Multer.prototype.none = function () {
return this._makeMiddleware([], 'NONE')
}
Multer.prototype.any = function () {
function setup () {
return {
limits: this.limits,
preservePath: this.preservePath,
defParamCharset: this.defParamCharset,
storage: this.storage,
fileFilter: this.fileFilter,
fileStrategy: 'ARRAY'
}
}
return makeMiddleware(setup.bind(this))
}
function multer (options) {
if (options === undefined) {
return new Multer({})
}
if (typeof options === 'object' && options !== null) {
return new Multer(options)
}
throw new TypeError('Expected object for argument options')
}
module.exports = multer
module.exports.diskStorage = diskStorage
module.exports.memoryStorage = memoryStorage
module.exports.MulterError = MulterError
expressjs-multer-2e2af08/lib/ 0000775 0000000 0000000 00000000000 15213763722 0016235 5 ustar 00root root 0000000 0000000 expressjs-multer-2e2af08/lib/counter.js 0000664 0000000 0000000 00000001072 15213763722 0020252 0 ustar 00root root 0000000 0000000 var EventEmitter = require('events').EventEmitter
function Counter () {
EventEmitter.call(this)
this.value = 0
}
Counter.prototype = Object.create(EventEmitter.prototype)
Counter.prototype.increment = function increment () {
this.value++
}
Counter.prototype.decrement = function decrement () {
if (--this.value === 0) this.emit('zero')
}
Counter.prototype.isZero = function isZero () {
return (this.value === 0)
}
Counter.prototype.onceZero = function onceZero (fn) {
if (this.isZero()) return fn()
this.once('zero', fn)
}
module.exports = Counter
expressjs-multer-2e2af08/lib/file-appender.js 0000664 0000000 0000000 00000003126 15213763722 0021310 0 ustar 00root root 0000000 0000000 function arrayRemove (arr, item) {
var idx = arr.indexOf(item)
if (~idx) arr.splice(idx, 1)
}
function FileAppender (strategy, req) {
this.strategy = strategy
this.req = req
switch (strategy) {
case 'NONE': break
case 'VALUE': break
case 'ARRAY': req.files = []; break
case 'OBJECT': req.files = Object.create(null); break
default: throw new Error('Unknown file strategy: ' + strategy)
}
}
FileAppender.prototype.insertPlaceholder = function (file) {
var placeholder = {
fieldname: file.fieldname
}
switch (this.strategy) {
case 'NONE': break
case 'VALUE': break
case 'ARRAY': this.req.files.push(placeholder); break
case 'OBJECT':
if (this.req.files[file.fieldname]) {
this.req.files[file.fieldname].push(placeholder)
} else {
this.req.files[file.fieldname] = [placeholder]
}
break
}
return placeholder
}
FileAppender.prototype.removePlaceholder = function (placeholder) {
switch (this.strategy) {
case 'NONE': break
case 'VALUE': break
case 'ARRAY': arrayRemove(this.req.files, placeholder); break
case 'OBJECT':
if (this.req.files[placeholder.fieldname].length === 1) {
delete this.req.files[placeholder.fieldname]
} else {
arrayRemove(this.req.files[placeholder.fieldname], placeholder)
}
break
}
}
FileAppender.prototype.replacePlaceholder = function (placeholder, file) {
if (this.strategy === 'VALUE') {
this.req.file = file
return
}
delete placeholder.fieldname
Object.assign(placeholder, file)
}
module.exports = FileAppender
expressjs-multer-2e2af08/lib/make-middleware.js 0000664 0000000 0000000 00000017062 15213763722 0021631 0 ustar 00root root 0000000 0000000 var is = require('type-is')
var Busboy = require('busboy')
var appendField = require('append-field')
var Counter = require('./counter')
var MulterError = require('./multer-error')
var FileAppender = require('./file-appender')
var removeUploadedFiles = require('./remove-uploaded-files')
function drainStream (stream) {
stream.on('readable', () => {
while (stream.read() !== null) {}
})
}
function makeMiddleware (setup) {
return function multerMiddleware (req, res, next) {
if (!is(req, ['multipart'])) return next()
var options = setup()
var limits = options.limits
var storage = options.storage
var fileFilter = options.fileFilter
var fileStrategy = options.fileStrategy
var preservePath = options.preservePath
var defParamCharset = options.defParamCharset
req.body = Object.create(null)
var busboy
var appender = null
var isDone = false
var readFinished = false
var errorOccured = false
var pendingWrites = new Counter()
var uploadedFiles = []
var pendingFiles = []
function done (err) {
var called = false
function onFinished () {
if (called) return
called = true
next(err)
}
if (isDone) return
isDone = true
if (busboy) {
req.unpipe(busboy)
setImmediate(() => {
busboy.removeAllListeners()
})
}
drainStream(req)
req.resume()
// - if responding with an error, drain request body before calling
// next(err) -- avoids EPIPE on the client (server closing connection
// while the client is still sending the request body)
// - also listen for 'close' so we don't hang when the client aborts (stream may never 'end')
// - skip waiting if the stream is already destroyed (e.g. client aborted)
if (err && req.readable && !req.destroyed) {
req.once('end', onFinished)
req.once('error', onFinished)
req.once('close', onFinished)
return
}
next(err)
}
function indicateDone () {
if (readFinished && pendingWrites.isZero() && !errorOccured) done()
}
function abortWithError (uploadError, skipPendingWait) {
if (errorOccured) return
errorOccured = true
function finishAbort () {
function remove (file, cb) {
storage._removeFile(req, file, cb)
}
var filesToRemove = uploadedFiles.concat(
pendingFiles.filter(function (f) { return f.path })
)
pendingFiles = []
removeUploadedFiles(filesToRemove, remove, function (err, storageErrors) {
if (err) return done(err)
uploadError.storageErrors = storageErrors
done(uploadError)
})
}
if (skipPendingWait) {
finishAbort()
} else {
pendingWrites.onceZero(finishAbort)
}
}
function abortWithCode (code, optionalField) {
abortWithError(new MulterError(code, optionalField))
}
function handleRequestFailure (err) {
if (isDone) return
if (busboy) {
req.unpipe(busboy)
busboy.destroy(err)
}
abortWithError(err, true)
}
req.on('error', function (err) {
handleRequestFailure(err || new Error('Request error'))
})
req.on('aborted', function () {
handleRequestFailure(new Error('Request aborted'))
})
req.on('close', function () {
if (req.readableEnded) return
handleRequestFailure(new Error('Request closed'))
})
try {
busboy = Busboy({
headers: req.headers,
limits: limits,
preservePath: preservePath,
defParamCharset: defParamCharset
})
} catch (err) {
return next(err)
}
appender = new FileAppender(fileStrategy, req)
// handle text field data
busboy.on('field', function (fieldname, value, { nameTruncated, valueTruncated }) {
if (fieldname == null) return abortWithCode('MISSING_FIELD_NAME')
if (nameTruncated) return abortWithCode('LIMIT_FIELD_KEY')
if (valueTruncated) return abortWithCode('LIMIT_FIELD_VALUE', fieldname)
// Work around bug in Busboy (https://github.com/mscdex/busboy/issues/6)
if (limits && Object.prototype.hasOwnProperty.call(limits, 'fieldNameSize')) {
if (fieldname.length > limits.fieldNameSize) return abortWithCode('LIMIT_FIELD_KEY')
}
if (limits && Object.prototype.hasOwnProperty.call(limits, 'fieldNestingDepth')) {
if (fieldname.split('[').length - 1 > limits.fieldNestingDepth) return abortWithCode('LIMIT_FIELD_NESTING', fieldname)
}
appendField(req.body, fieldname, value)
})
// handle files
busboy.on('file', function (fieldname, fileStream, { filename, encoding, mimeType }) {
var pendingWritesIncremented = false
fileStream.on('error', function (err) {
if (pendingWritesIncremented) {
pendingWrites.decrement()
}
abortWithError(err)
})
if (fieldname == null) return abortWithCode('MISSING_FIELD_NAME')
// don't attach to the files object, if there is no file
if (!filename) return fileStream.resume()
// Work around bug in Busboy (https://github.com/mscdex/busboy/issues/6)
if (limits && Object.prototype.hasOwnProperty.call(limits, 'fieldNameSize')) {
if (fieldname.length > limits.fieldNameSize) return abortWithCode('LIMIT_FIELD_KEY')
}
var file = {
fieldname: fieldname,
originalname: filename,
encoding: encoding,
mimetype: mimeType
}
var placeholder = appender.insertPlaceholder(file)
fileFilter(req, file, function (err, includeFile) {
if (errorOccured) {
appender.removePlaceholder(placeholder)
return fileStream.resume()
}
if (err) {
appender.removePlaceholder(placeholder)
return abortWithError(err)
}
if (!includeFile) {
appender.removePlaceholder(placeholder)
return fileStream.resume()
}
var aborting = false
pendingWritesIncremented = true
pendingWrites.increment()
Object.defineProperty(file, 'stream', {
configurable: true,
enumerable: false,
value: fileStream
})
fileStream.on('limit', function () {
aborting = true
abortWithCode('LIMIT_FILE_SIZE', fieldname)
})
pendingFiles.push(file)
storage._handleFile(req, file, function (err, info) {
var idx = pendingFiles.indexOf(file)
if (idx !== -1) pendingFiles.splice(idx, 1)
if (aborting) {
appender.removePlaceholder(placeholder)
uploadedFiles.push({ ...file, ...info })
return pendingWrites.decrement()
}
if (err) {
appender.removePlaceholder(placeholder)
pendingWrites.decrement()
return abortWithError(err)
}
var fileInfo = { ...file, ...info }
appender.replacePlaceholder(placeholder, fileInfo)
uploadedFiles.push(fileInfo)
pendingWrites.decrement()
indicateDone()
})
})
})
busboy.on('error', function (err) { abortWithError(err) })
busboy.on('partsLimit', function () { abortWithCode('LIMIT_PART_COUNT') })
busboy.on('filesLimit', function () { abortWithCode('LIMIT_FILE_COUNT') })
busboy.on('fieldsLimit', function () { abortWithCode('LIMIT_FIELD_COUNT') })
busboy.on('close', function () {
readFinished = true
indicateDone()
})
req.pipe(busboy)
}
}
module.exports = makeMiddleware
expressjs-multer-2e2af08/lib/multer-error.js 0000664 0000000 0000000 00000001311 15213763722 0021226 0 ustar 00root root 0000000 0000000 var util = require('util')
var errorMessages = {
LIMIT_PART_COUNT: 'Too many parts',
LIMIT_FILE_SIZE: 'File too large',
LIMIT_FILE_COUNT: 'Too many files',
LIMIT_FIELD_KEY: 'Field name too long',
LIMIT_FIELD_VALUE: 'Field value too long',
LIMIT_FIELD_COUNT: 'Too many fields',
LIMIT_UNEXPECTED_FILE: 'Unexpected field',
MISSING_FIELD_NAME: 'Field name missing',
LIMIT_FIELD_NESTING: 'Field name nesting too deep'
}
function MulterError (code, field) {
Error.captureStackTrace(this, this.constructor)
this.name = this.constructor.name
this.message = errorMessages[code]
this.code = code
if (field) this.field = field
}
util.inherits(MulterError, Error)
module.exports = MulterError
expressjs-multer-2e2af08/lib/remove-uploaded-files.js 0000664 0000000 0000000 00000001074 15213763722 0022765 0 ustar 00root root 0000000 0000000 function removeUploadedFiles (uploadedFiles, remove, cb) {
var length = uploadedFiles.length
var errors = []
if (length === 0) return cb(null, errors)
function handleFile (idx) {
var file = uploadedFiles[idx]
remove(file, function (err) {
if (err) {
err.file = file
err.field = file.fieldname
errors.push(err)
}
if (idx < length - 1) {
setImmediate(function () { handleFile(idx + 1) })
} else {
cb(null, errors)
}
})
}
handleFile(0)
}
module.exports = removeUploadedFiles
expressjs-multer-2e2af08/package.json 0000664 0000000 0000000 00000002544 15213763722 0017762 0 ustar 00root root 0000000 0000000 {
"name": "multer",
"description": "Middleware for handling `multipart/form-data`.",
"version": "2.2.0",
"contributors": [
"Hage Yaapa
(http://www.hacksparrow.com)",
"Jaret Pfluger ",
"Linus Unnebäck "
],
"license": "MIT",
"repository": "expressjs/multer",
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/express"
},
"keywords": [
"form",
"post",
"multipart",
"form-data",
"formdata",
"express",
"middleware"
],
"dependencies": {
"append-field": "^1.0.0",
"busboy": "^1.6.0",
"concat-stream": "^2.0.0",
"type-is": "^1.6.18"
},
"devDependencies": {
"deep-equal": "^2.0.3",
"express": "^4.21.2",
"form-data": "^4.0.2",
"fs-temp": "^1.2.1",
"mocha": "^11.5.0",
"nyc": "^15.1.0",
"rimraf": "^2.4.1",
"standard": "^14.3.3",
"testdata-w3c-json-form": "^1.0.0"
},
"engines": {
"node": ">= 10.16.0"
},
"files": [
"LICENSE",
"index.js",
"storage/",
"lib/"
],
"scripts": {
"lint": "standard",
"lint:fix": "standard --fix",
"test": "mocha --reporter spec --exit --check-leaks test/",
"test-ci": "nyc --reporter=lcov --reporter=text npm test",
"test-cov": "nyc --reporter=html --reporter=text npm test"
}
}
expressjs-multer-2e2af08/storage/ 0000775 0000000 0000000 00000000000 15213763722 0017133 5 ustar 00root root 0000000 0000000 expressjs-multer-2e2af08/storage/disk.js 0000664 0000000 0000000 00000003215 15213763722 0020424 0 ustar 00root root 0000000 0000000 var fs = require('fs')
var os = require('os')
var path = require('path')
var crypto = require('crypto')
function getFilename (req, file, cb) {
crypto.randomBytes(16, function (err, raw) {
cb(err, err ? undefined : raw.toString('hex'))
})
}
function getDestination (req, file, cb) {
cb(null, os.tmpdir())
}
function DiskStorage (opts) {
this.getFilename = (opts.filename || getFilename)
if (typeof opts.destination === 'string') {
fs.mkdirSync(opts.destination, { recursive: true })
this.getDestination = function ($0, $1, cb) { cb(null, opts.destination) }
} else {
this.getDestination = (opts.destination || getDestination)
}
}
DiskStorage.prototype._handleFile = function _handleFile (req, file, cb) {
var that = this
that.getDestination(req, file, function (err, destination) {
if (err) return cb(err)
that.getFilename(req, file, function (err, filename) {
if (err) return cb(err)
var finalPath = path.join(destination, filename)
if (file.stream.destroyed) return
var outStream = fs.createWriteStream(finalPath)
file.path = finalPath
file.stream.pipe(outStream)
outStream.on('error', cb)
outStream.on('finish', function () {
cb(null, {
destination: destination,
filename: filename,
path: finalPath,
size: outStream.bytesWritten
})
})
})
})
}
DiskStorage.prototype._removeFile = function _removeFile (req, file, cb) {
var path = file.path
delete file.destination
delete file.filename
delete file.path
fs.unlink(path, cb)
}
module.exports = function (opts) {
return new DiskStorage(opts)
}
expressjs-multer-2e2af08/storage/memory.js 0000664 0000000 0000000 00000000733 15213763722 0021004 0 ustar 00root root 0000000 0000000 var concat = require('concat-stream')
function MemoryStorage (opts) {}
MemoryStorage.prototype._handleFile = function _handleFile (req, file, cb) {
file.stream.pipe(concat({ encoding: 'buffer' }, function (data) {
cb(null, {
buffer: data,
size: data.length
})
}))
}
MemoryStorage.prototype._removeFile = function _removeFile (req, file, cb) {
delete file.buffer
cb(null)
}
module.exports = function (opts) {
return new MemoryStorage(opts)
}
expressjs-multer-2e2af08/test/ 0000775 0000000 0000000 00000000000 15213763722 0016446 5 ustar 00root root 0000000 0000000 expressjs-multer-2e2af08/test/_util.js 0000664 0000000 0000000 00000001235 15213763722 0020121 0 ustar 00root root 0000000 0000000 var fs = require('fs')
var path = require('path')
var stream = require('stream')
exports.file = function file (name) {
return fs.createReadStream(path.join(__dirname, 'files', name))
}
exports.fileSize = function fileSize (path) {
return fs.statSync(path).size
}
exports.submitForm = function submitForm (multer, form, cb) {
form.getLength(function (err, length) {
if (err) return cb(err)
var req = new stream.PassThrough()
form.pipe(req)
req.headers = {
'content-type': 'multipart/form-data; boundary=' + form.getBoundary(),
'content-length': length
}
multer(req, null, function (err) {
cb(err, req)
})
})
}
expressjs-multer-2e2af08/test/async-file-filter-orphan.js 0000664 0000000 0000000 00000004144 15213763722 0023611 0 ustar 00root root 0000000 0000000 /* eslint-env mocha */
var assert = require('assert')
var fs = require('fs')
var os = require('os')
var path = require('path')
var http = require('http')
var express = require('express')
var multer = require('../')
describe('async fileFilter cleanup', function () {
it('does not leave orphan files when request aborts with missing field name', function (done) {
var uploadDir = fs.mkdtempSync(path.join(os.tmpdir(), 'multer-orphan-'))
var app = express()
var upload = multer({
dest: uploadDir,
fileFilter: function (req, file, cb) {
setImmediate(function () { cb(null, true) })
}
})
app.post('/upload', upload.any(), function (req, res) {
res.json({ success: true })
})
app.use(function (err, req, res, next) {
res.status(400).json({ error: err.code })
})
var server = app.listen(0, function () {
var port = server.address().port
var boundary = 'TestBound'
var body =
'--' + boundary + '\r\n' +
'Content-Disposition: form-data; name="f"; filename="a.bin"\r\n' +
'Content-Type: application/octet-stream\r\n\r\nORPHAN FILE DATA\r\n' +
'--' + boundary + '\r\n' +
'Content-Disposition: form-data; filename="b.bin"\r\n' +
'Content-Type: application/octet-stream\r\n\r\nx\r\n' +
'--' + boundary + '--\r\n'
var req = http.request({
hostname: 'localhost',
port: port,
path: '/upload',
method: 'POST',
headers: {
'Content-Type': 'multipart/form-data; boundary=' + boundary,
'Content-Length': Buffer.byteLength(body)
}
}, function (res) {
res.resume()
res.on('end', function () {
setTimeout(function () {
var files = fs.readdirSync(uploadDir)
assert.strictEqual(res.statusCode, 400)
assert.strictEqual(files.length, 0)
server.close(done)
}, 500)
})
})
req.on('error', function (err) {
server.close(function () {
done(err)
})
})
req.write(body)
req.end()
})
})
}
)
expressjs-multer-2e2af08/test/def-param-charset.js 0000664 0000000 0000000 00000023175 15213763722 0022277 0 ustar 00root root 0000000 0000000 /* eslint-env mocha */
var assert = require('assert')
var stream = require('stream')
var multer = require('../')
var temp = require('fs-temp')
var rimraf = require('rimraf')
describe('defParamCharset', function () {
var uploadDir, upload
beforeEach(function (done) {
temp.mkdir(function (err, path) {
if (err) return done(err)
var storage = multer.diskStorage({
destination: path,
filename: function (req, file, cb) {
cb(null, file.originalname)
}
})
uploadDir = path
upload = multer({ storage: storage })
done()
})
})
afterEach(function (done) {
rimraf(uploadDir, done)
})
it('should use latin1 as default charset for non-extended parameters', function (done) {
var req = new stream.PassThrough()
var boundary = 'AaB03x'
// Create a filename with latin1 characters (e.g., café encoded as latin1)
// In latin1: é = 0xE9
var bodyParts = [
'--' + boundary,
'Content-Disposition: form-data; name="testfile"; filename="caf',
'.txt"',
'Content-Type: text/plain',
'',
'test file content',
'--' + boundary + '--'
]
// Create buffer with proper latin1 encoding
var bodyBuffer = Buffer.concat([
Buffer.from(bodyParts[0] + '\r\n', 'ascii'),
Buffer.from(bodyParts[1], 'ascii'),
Buffer.from([0xE9]), // é in latin1
Buffer.from(bodyParts[2] + '\r\n', 'ascii'),
Buffer.from(bodyParts[3] + '\r\n', 'ascii'),
Buffer.from(bodyParts[4] + '\r\n', 'ascii'),
Buffer.from(bodyParts[5] + '\r\n', 'ascii'),
Buffer.from(bodyParts[6], 'ascii')
])
req.headers = {
'content-type': 'multipart/form-data; boundary=' + boundary,
'content-length': bodyBuffer.length
}
req.end(bodyBuffer)
upload.single('testfile')(req, null, function (err) {
assert.ifError(err)
// With latin1 (default), the filename should be interpreted as latin1
assert.strictEqual(req.file.originalname, 'café.txt')
assert.strictEqual(req.file.fieldname, 'testfile')
done()
})
})
it('should use custom charset when defParamCharset is specified', function (done) {
var customUpload = multer({
storage: multer.diskStorage({
destination: uploadDir,
filename: function (req, file, cb) {
cb(null, file.originalname)
}
}),
defParamCharset: 'utf8'
})
var req = new stream.PassThrough()
var boundary = 'AaB03x'
// Create a filename with UTF-8 characters (e.g., café encoded as UTF-8)
// In UTF-8: é = 0xC3 0xA9
var bodyParts = [
'--' + boundary,
'Content-Disposition: form-data; name="testfile"; filename="caf',
'.txt"',
'Content-Type: text/plain',
'',
'test file content',
'--' + boundary + '--'
]
// Create buffer with proper UTF-8 encoding
var bodyBuffer = Buffer.concat([
Buffer.from(bodyParts[0] + '\r\n', 'ascii'),
Buffer.from(bodyParts[1], 'ascii'),
Buffer.from([0xC3, 0xA9]), // é in UTF-8
Buffer.from(bodyParts[2] + '\r\n', 'ascii'),
Buffer.from(bodyParts[3] + '\r\n', 'ascii'),
Buffer.from(bodyParts[4] + '\r\n', 'ascii'),
Buffer.from(bodyParts[5] + '\r\n', 'ascii'),
Buffer.from(bodyParts[6], 'ascii')
])
req.headers = {
'content-type': 'multipart/form-data; boundary=' + boundary,
'content-length': bodyBuffer.length
}
req.end(bodyBuffer)
customUpload.single('testfile')(req, null, function (err) {
assert.ifError(err)
// With utf8, the filename should be interpreted as utf8
assert.strictEqual(req.file.originalname, 'café.txt')
assert.strictEqual(req.file.fieldname, 'testfile')
done()
})
})
it('should not affect extended parameters with explicit charset', function (done) {
var customUpload = multer({
storage: multer.diskStorage({
destination: uploadDir,
filename: function (req, file, cb) {
cb(null, file.originalname)
}
}),
defParamCharset: 'ascii' // This should be ignored for extended parameters
})
var req = new stream.PassThrough()
var boundary = 'AaB03x'
var body = [
'--' + boundary,
// Extended parameter with explicit UTF-8 charset should override defParamCharset
'Content-Disposition: form-data; name="testfile"; filename*=utf-8\'\'caf%C3%A9.txt',
'Content-Type: text/plain',
'',
'test file content',
'--' + boundary + '--'
].join('\r\n')
req.headers = {
'content-type': 'multipart/form-data; boundary=' + boundary,
'content-length': body.length
}
req.end(body)
customUpload.single('testfile')(req, null, function (err) {
assert.ifError(err)
// Extended parameter should use its own charset (UTF-8), not defParamCharset
assert.strictEqual(req.file.originalname, 'café.txt')
assert.strictEqual(req.file.fieldname, 'testfile')
done()
})
})
it('should handle different charsets correctly', function (done) {
var customUpload = multer({
storage: multer.diskStorage({
destination: uploadDir,
filename: function (req, file, cb) {
cb(null, file.originalname)
}
}),
defParamCharset: 'iso-8859-1' // Same as latin1
})
var req = new stream.PassThrough()
var boundary = 'AaB03x'
// Test with ISO-8859-1 encoded characters
var bodyParts = [
'--' + boundary,
'Content-Disposition: form-data; name="testfile"; filename="test',
'.txt"',
'Content-Type: text/plain',
'',
'test file content',
'--' + boundary + '--'
]
// Create buffer with proper ISO-8859-1 encoding
var bodyBuffer = Buffer.concat([
Buffer.from(bodyParts[0] + '\r\n', 'ascii'),
Buffer.from(bodyParts[1], 'ascii'),
Buffer.from([0xF1]), // ñ in ISO-8859-1
Buffer.from(bodyParts[2] + '\r\n', 'ascii'),
Buffer.from(bodyParts[3] + '\r\n', 'ascii'),
Buffer.from(bodyParts[4] + '\r\n', 'ascii'),
Buffer.from(bodyParts[5] + '\r\n', 'ascii'),
Buffer.from(bodyParts[6], 'ascii')
])
req.headers = {
'content-type': 'multipart/form-data; boundary=' + boundary,
'content-length': bodyBuffer.length
}
req.end(bodyBuffer)
customUpload.single('testfile')(req, null, function (err) {
assert.ifError(err)
// Should correctly decode the ñ character
assert.strictEqual(req.file.originalname, 'testñ.txt')
assert.strictEqual(req.file.fieldname, 'testfile')
done()
})
})
it('should work with memory storage', function (done) {
var memoryUpload = multer({
storage: multer.memoryStorage(),
defParamCharset: 'utf8'
})
var req = new stream.PassThrough()
var boundary = 'AaB03x'
var bodyParts = [
'--' + boundary,
'Content-Disposition: form-data; name="testfile"; filename="test',
'.txt"',
'Content-Type: text/plain',
'',
'test file content',
'--' + boundary + '--'
]
// Create buffer with proper UTF-8 encoding
var bodyBuffer = Buffer.concat([
Buffer.from(bodyParts[0] + '\r\n', 'ascii'),
Buffer.from(bodyParts[1], 'ascii'),
Buffer.from([0xC3, 0xA9]), // é in UTF-8
Buffer.from(bodyParts[2] + '\r\n', 'ascii'),
Buffer.from(bodyParts[3] + '\r\n', 'ascii'),
Buffer.from(bodyParts[4] + '\r\n', 'ascii'),
Buffer.from(bodyParts[5] + '\r\n', 'ascii'),
Buffer.from(bodyParts[6], 'ascii')
])
req.headers = {
'content-type': 'multipart/form-data; boundary=' + boundary,
'content-length': bodyBuffer.length
}
req.end(bodyBuffer)
memoryUpload.single('testfile')(req, null, function (err) {
assert.ifError(err)
assert.strictEqual(req.file.originalname, 'testé.txt')
assert.strictEqual(req.file.fieldname, 'testfile')
assert.ok(Buffer.isBuffer(req.file.buffer))
done()
})
})
it('should work with array uploads', function (done) {
var customUpload = multer({
storage: multer.diskStorage({
destination: uploadDir,
filename: function (req, file, cb) {
cb(null, file.originalname)
}
}),
defParamCharset: 'utf8'
})
var req = new stream.PassThrough()
var boundary = 'AaB03x'
// Create buffer with proper UTF-8 encoding for both files
var bodyBuffer = Buffer.concat([
Buffer.from('--' + boundary + '\r\n', 'ascii'),
Buffer.from('Content-Disposition: form-data; name="testfiles"; filename="file1', 'ascii'),
Buffer.from([0xC3, 0xA9]), // é in UTF-8
Buffer.from('.txt"\r\n', 'ascii'),
Buffer.from('Content-Type: text/plain\r\n', 'ascii'),
Buffer.from('\r\n', 'ascii'),
Buffer.from('test file 1 content\r\n', 'ascii'),
Buffer.from('--' + boundary + '\r\n', 'ascii'),
Buffer.from('Content-Disposition: form-data; name="testfiles"; filename="file2', 'ascii'),
Buffer.from([0xC3, 0xB1]), // ñ in UTF-8
Buffer.from('.txt"\r\n', 'ascii'),
Buffer.from('Content-Type: text/plain\r\n', 'ascii'),
Buffer.from('\r\n', 'ascii'),
Buffer.from('test file 2 content\r\n', 'ascii'),
Buffer.from('--' + boundary + '--', 'ascii')
])
req.headers = {
'content-type': 'multipart/form-data; boundary=' + boundary,
'content-length': bodyBuffer.length
}
req.end(bodyBuffer)
customUpload.array('testfiles', 2)(req, null, function (err) {
assert.ifError(err)
assert.strictEqual(req.files.length, 2)
assert.strictEqual(req.files[0].originalname, 'file1é.txt')
assert.strictEqual(req.files[1].originalname, 'file2ñ.txt')
done()
})
})
})
expressjs-multer-2e2af08/test/disk-storage.js 0000664 0000000 0000000 00000014247 15213763722 0021410 0 ustar 00root root 0000000 0000000 /* eslint-env mocha */
var assert = require('assert')
var deepEqual = require('deep-equal')
var fs = require('fs')
var path = require('path')
var util = require('./_util')
var multer = require('../')
var temp = require('fs-temp')
var rimraf = require('rimraf')
var FormData = require('form-data')
describe('Disk Storage', function () {
var uploadDir, upload
beforeEach(function (done) {
temp.mkdir(function (err, path) {
if (err) return done(err)
uploadDir = path
upload = multer({ dest: path })
done()
})
})
afterEach(function (done) {
rimraf(uploadDir, done)
})
it('should process parser/form-data POST request', function (done) {
var form = new FormData()
var parser = upload.single('small0')
form.append('name', 'Multer')
form.append('small0', util.file('small0.dat'))
util.submitForm(parser, form, function (err, req) {
assert.ifError(err)
assert.strictEqual(req.body.name, 'Multer')
assert.strictEqual(req.file.fieldname, 'small0')
assert.strictEqual(req.file.originalname, 'small0.dat')
assert.strictEqual(req.file.size, 1778)
assert.strictEqual(util.fileSize(req.file.path), 1778)
done()
})
})
it('should process empty fields and an empty file', function (done) {
var form = new FormData()
var parser = upload.single('empty')
form.append('empty', util.file('empty.dat'))
form.append('name', 'Multer')
form.append('version', '')
form.append('year', '')
form.append('checkboxfull', 'cb1')
form.append('checkboxfull', 'cb2')
form.append('checkboxhalfempty', 'cb1')
form.append('checkboxhalfempty', '')
form.append('checkboxempty', '')
form.append('checkboxempty', '')
util.submitForm(parser, form, function (err, req) {
assert.ifError(err)
assert.strictEqual(req.body.name, 'Multer')
assert.strictEqual(req.body.version, '')
assert.strictEqual(req.body.year, '')
assert(deepEqual(req.body.checkboxfull, ['cb1', 'cb2']))
assert(deepEqual(req.body.checkboxhalfempty, ['cb1', '']))
assert(deepEqual(req.body.checkboxempty, ['', '']))
assert.strictEqual(req.file.fieldname, 'empty')
assert.strictEqual(req.file.originalname, 'empty.dat')
assert.strictEqual(req.file.size, 0)
assert.strictEqual(util.fileSize(req.file.path), 0)
done()
})
})
it('should process multiple files', function (done) {
var form = new FormData()
var parser = upload.fields([
{ name: 'empty', maxCount: 1 },
{ name: 'tiny0', maxCount: 1 },
{ name: 'tiny1', maxCount: 1 },
{ name: 'small0', maxCount: 1 },
{ name: 'small1', maxCount: 1 },
{ name: 'medium', maxCount: 1 },
{ name: 'large', maxCount: 1 }
])
form.append('empty', util.file('empty.dat'))
form.append('tiny0', util.file('tiny0.dat'))
form.append('tiny1', util.file('tiny1.dat'))
form.append('small0', util.file('small0.dat'))
form.append('small1', util.file('small1.dat'))
form.append('medium', util.file('medium.dat'))
form.append('large', util.file('large.jpg'))
util.submitForm(parser, form, function (err, req) {
assert.ifError(err)
assert(deepEqual(req.body, {}))
assert.strictEqual(req.files.empty[0].fieldname, 'empty')
assert.strictEqual(req.files.empty[0].originalname, 'empty.dat')
assert.strictEqual(req.files.empty[0].size, 0)
assert.strictEqual(util.fileSize(req.files.empty[0].path), 0)
assert.strictEqual(req.files.tiny0[0].fieldname, 'tiny0')
assert.strictEqual(req.files.tiny0[0].originalname, 'tiny0.dat')
assert.strictEqual(req.files.tiny0[0].size, 122)
assert.strictEqual(util.fileSize(req.files.tiny0[0].path), 122)
assert.strictEqual(req.files.tiny1[0].fieldname, 'tiny1')
assert.strictEqual(req.files.tiny1[0].originalname, 'tiny1.dat')
assert.strictEqual(req.files.tiny1[0].size, 7)
assert.strictEqual(util.fileSize(req.files.tiny1[0].path), 7)
assert.strictEqual(req.files.small0[0].fieldname, 'small0')
assert.strictEqual(req.files.small0[0].originalname, 'small0.dat')
assert.strictEqual(req.files.small0[0].size, 1778)
assert.strictEqual(util.fileSize(req.files.small0[0].path), 1778)
assert.strictEqual(req.files.small1[0].fieldname, 'small1')
assert.strictEqual(req.files.small1[0].originalname, 'small1.dat')
assert.strictEqual(req.files.small1[0].size, 315)
assert.strictEqual(util.fileSize(req.files.small1[0].path), 315)
assert.strictEqual(req.files.medium[0].fieldname, 'medium')
assert.strictEqual(req.files.medium[0].originalname, 'medium.dat')
assert.strictEqual(req.files.medium[0].size, 13196)
assert.strictEqual(util.fileSize(req.files.medium[0].path), 13196)
assert.strictEqual(req.files.large[0].fieldname, 'large')
assert.strictEqual(req.files.large[0].originalname, 'large.jpg')
assert.strictEqual(req.files.large[0].size, 2413677)
assert.strictEqual(util.fileSize(req.files.large[0].path), 2413677)
done()
})
})
it('should remove uploaded files on error', function (done) {
var form = new FormData()
var parser = upload.single('tiny0')
form.append('tiny0', util.file('tiny0.dat'))
form.append('small0', util.file('small0.dat'))
util.submitForm(parser, form, function (err, req) {
assert.strictEqual(err.code, 'LIMIT_UNEXPECTED_FILE')
assert.strictEqual(err.field, 'small0')
assert(deepEqual(err.storageErrors, []))
var files = fs.readdirSync(uploadDir)
assert(deepEqual(files, []))
done()
})
})
it('should report error when directory doesn\'t exist', function (done) {
var directory = path.join(temp.mkdirSync(), 'ghost')
function dest ($0, $1, cb) { cb(null, directory) }
var storage = multer.diskStorage({ destination: dest })
var upload = multer({ storage: storage })
var parser = upload.single('tiny0')
var form = new FormData()
form.append('tiny0', util.file('tiny0.dat'))
util.submitForm(parser, form, function (err, req) {
assert.strictEqual(err.code, 'ENOENT')
assert.strictEqual(path.dirname(err.path), directory)
done()
})
})
})
expressjs-multer-2e2af08/test/error-handling.js 0000664 0000000 0000000 00000031640 15213763722 0021723 0 ustar 00root root 0000000 0000000 /* eslint-env mocha */
var assert = require('assert')
var os = require('os')
var util = require('./_util')
var multer = require('../')
var removeUploadedFiles = require('../lib/remove-uploaded-files')
var stream = require('stream')
var FormData = require('form-data')
var http = require('http')
var net = require('net')
function withLimits (limits, fields) {
var storage = multer.memoryStorage()
return multer({ storage: storage, limits: limits }).fields(fields)
}
describe('Error Handling', function () {
it('should be an instance of both `Error` and `MulterError` classes in case of the Multer\'s error', function (done) {
var form = new FormData()
var storage = multer.diskStorage({ destination: os.tmpdir() })
var upload = multer({ storage: storage }).fields([
{ name: 'small0', maxCount: 1 }
])
form.append('small0', util.file('small0.dat'))
form.append('small0', util.file('small0.dat'))
util.submitForm(upload, form, function (err, req) {
assert.strictEqual(err instanceof Error, true)
assert.strictEqual(err instanceof multer.MulterError, true)
done()
})
})
it('should respect parts limit', function (done) {
var form = new FormData()
var parser = withLimits({ parts: 1 }, [
{ name: 'small0', maxCount: 1 }
])
form.append('field0', 'BOOM!')
form.append('small0', util.file('small0.dat'))
util.submitForm(parser, form, function (err, req) {
assert.strictEqual(err.code, 'LIMIT_PART_COUNT')
done()
})
})
it('should respect file size limit', function (done) {
var form = new FormData()
var parser = withLimits({ fileSize: 1500 }, [
{ name: 'tiny0', maxCount: 1 },
{ name: 'small0', maxCount: 1 }
])
form.append('tiny0', util.file('tiny0.dat'))
form.append('small0', util.file('small0.dat'))
util.submitForm(parser, form, function (err, req) {
assert.strictEqual(err.code, 'LIMIT_FILE_SIZE')
assert.strictEqual(err.field, 'small0')
done()
})
})
it('should respect file count limit', function (done) {
var form = new FormData()
var parser = withLimits({ files: 1 }, [
{ name: 'small0', maxCount: 1 },
{ name: 'small1', maxCount: 1 }
])
form.append('small0', util.file('small0.dat'))
form.append('small1', util.file('small1.dat'))
util.submitForm(parser, form, function (err, req) {
assert.strictEqual(err.code, 'LIMIT_FILE_COUNT')
done()
})
})
it('should respect file key limit', function (done) {
var form = new FormData()
var parser = withLimits({ fieldNameSize: 4 }, [
{ name: 'small0', maxCount: 1 }
])
form.append('small0', util.file('small0.dat'))
util.submitForm(parser, form, function (err, req) {
assert.strictEqual(err.code, 'LIMIT_FIELD_KEY')
done()
})
})
it('should respect field key limit', function (done) {
var form = new FormData()
var parser = withLimits({ fieldNameSize: 4 }, [])
form.append('ok', 'SMILE')
form.append('blowup', 'BOOM!')
util.submitForm(parser, form, function (err, req) {
assert.strictEqual(err.code, 'LIMIT_FIELD_KEY')
done()
})
})
it('should respect field value limit', function (done) {
var form = new FormData()
var parser = withLimits({ fieldSize: 16 }, [])
form.append('field0', 'This is okay')
form.append('field1', 'This will make the parser explode')
util.submitForm(parser, form, function (err, req) {
assert.strictEqual(err.code, 'LIMIT_FIELD_VALUE')
assert.strictEqual(err.field, 'field1')
done()
})
})
it('should respect field count limit', function (done) {
var form = new FormData()
var parser = withLimits({ fields: 1 }, [])
form.append('field0', 'BOOM!')
form.append('field1', 'BOOM!')
util.submitForm(parser, form, function (err, req) {
assert.strictEqual(err.code, 'LIMIT_FIELD_COUNT')
done()
})
})
it('should respect fields given', function (done) {
var form = new FormData()
var parser = withLimits(undefined, [
{ name: 'wrongname', maxCount: 1 }
])
form.append('small0', util.file('small0.dat'))
util.submitForm(parser, form, function (err, req) {
assert.strictEqual(err.code, 'LIMIT_UNEXPECTED_FILE')
assert.strictEqual(err.field, 'small0')
done()
})
})
it('should notify of missing field name', function (done) {
var req = new stream.PassThrough()
var storage = multer.memoryStorage()
var upload = multer({ storage: storage }).single('tiny0')
var boundary = 'AaB03x'
var body = [
'--' + boundary,
'Content-Disposition: form-data',
'',
'test content',
'--' + boundary,
''
].join('\r\n')
req.headers = {
'content-type': 'multipart/form-data; boundary=' + boundary,
'content-length': body.length
}
req.end(body)
upload(req, null, function (err) {
assert.strictEqual(err.code, 'MISSING_FIELD_NAME')
done()
})
})
it('should notify of missing field name', function (done) {
var form = new FormData()
var storage = multer.memoryStorage()
var parser = multer({ storage: storage }).single('small0')
form.append('', util.file('small0.dat'))
util.submitForm(parser, form, function (err, req) {
assert.strictEqual(err.code, 'MISSING_FIELD_NAME')
done()
})
})
it('should report errors from storage engines', function (done) {
var storage = multer.memoryStorage()
storage._removeFile = function _removeFile (req, file, cb) {
var err = new Error('Test error')
err.code = 'TEST'
cb(err)
}
var form = new FormData()
var upload = multer({ storage: storage })
var parser = upload.single('tiny0')
form.append('tiny0', util.file('tiny0.dat'))
form.append('small0', util.file('small0.dat'))
util.submitForm(parser, form, function (err, req) {
assert.strictEqual(err.code, 'LIMIT_UNEXPECTED_FILE')
assert.strictEqual(err.field, 'small0')
assert.strictEqual(err.storageErrors.length, 1)
assert.strictEqual(err.storageErrors[0].code, 'TEST')
assert.strictEqual(err.storageErrors[0].field, 'tiny0')
assert.strictEqual(err.storageErrors[0].file, req.file)
done()
})
})
it('should report errors from busboy constructor', function (done) {
var req = new stream.PassThrough()
var storage = multer.memoryStorage()
var upload = multer({ storage: storage }).single('tiny0')
var body = 'test'
req.headers = {
'content-type': 'multipart/form-data',
'content-length': body.length
}
req.end(body)
upload(req, null, function (err) {
assert.strictEqual(err.message, 'Multipart: Boundary not found')
done()
})
})
it('should report errors from busboy parsing', function (done) {
var req = new stream.PassThrough()
var storage = multer.memoryStorage()
var upload = multer({ storage: storage }).single('tiny0')
var boundary = 'AaB03x'
var body = [
'--' + boundary,
'Content-Disposition: form-data; name="tiny0"; filename="test.txt"',
'Content-Type: text/plain',
'',
'test without end boundary'
].join('\r\n')
req.headers = {
'content-type': 'multipart/form-data; boundary=' + boundary,
'content-length': body.length
}
req.end(body)
upload(req, null, function (err) {
assert.strictEqual(err.message, 'Unexpected end of form')
done()
})
})
it('should gracefully handle more than one error at a time', function (done) {
var form = new FormData()
var storage = multer.diskStorage({ destination: os.tmpdir() })
var upload = multer({ storage: storage, limits: { fileSize: 1, files: 1 } }).fields([
{ name: 'small0', maxCount: 1 }
])
form.append('small0', util.file('small0.dat'))
form.append('small0', util.file('small0.dat'))
util.submitForm(upload, form, function (err, req) {
assert.strictEqual(err.code, 'LIMIT_FILE_SIZE')
done()
})
})
it('should allow client to finish sending body before error response', function (done) {
this.timeout(10000)
var upload = multer({ storage: multer.memoryStorage() }).single('expected')
var server = http.createServer(function (req, res) {
upload(req, res, function (err) {
res.statusCode = err ? 500 : 200
res.end(err ? err.code : 'OK')
})
})
server.listen(0, function () {
var port = server.address().port
var boundary = 'Drain' + Date.now()
var preamble = [
'--' + boundary,
'Content-Disposition: form-data; name="unexpected"; filename="test.bin"',
'Content-Type: application/octet-stream',
'',
''
].join('\r\n')
var footer = '\r\n--' + boundary + '--\r\n'
var chunk = Buffer.alloc(32 * 1024, 97)
var totalChunks = 24
var contentLength = Buffer.byteLength(preamble) +
(chunk.length * totalChunks) +
Buffer.byteLength(footer)
var sock = new net.Socket()
var socketError = null
var response = ''
var sentChunks = 0
var finished = false
var timeout = setTimeout(function () {
if (finished) return
finished = true
sock.destroy()
server.close(function () {
done(new Error('timed out while uploading request body'))
})
}, 8000)
function finish (err) {
if (finished) return
finished = true
clearTimeout(timeout)
server.close(function () {
done(err)
})
}
function writeChunk () {
if (sentChunks >= totalChunks) {
sock.write(footer)
return
}
sentChunks += 1
var canContinue = sock.write(chunk)
if (canContinue) {
setTimeout(writeChunk, 2)
} else {
sock.once('drain', function () {
setTimeout(writeChunk, 2)
})
}
}
sock.connect(port, '127.0.0.1', function () {
sock.write(
'POST / HTTP/1.1\r\n' +
'Host: localhost\r\n' +
'Connection: close\r\n' +
'Content-Type: multipart/form-data; boundary=' + boundary + '\r\n' +
'Content-Length: ' + contentLength + '\r\n\r\n'
)
sock.write(preamble)
writeChunk()
})
sock.on('data', function (buf) {
response += buf.toString('utf8')
})
sock.on('error', function (err) {
socketError = err
})
sock.on('close', function () {
if (socketError) return finish(socketError)
try {
assert.strictEqual(sentChunks, totalChunks)
assert.ok(/HTTP\/1\.1 500/.test(response))
finish()
} catch (err) {
finish(err)
}
})
})
})
it('should not hang when client aborts multipart upload', function (done) {
this.timeout(5000)
var upload = multer({ storage: multer.memoryStorage() }).any()
var server = http.createServer(function (req, res) {
var hung = false
var timer = setTimeout(function () {
hung = true
server.close()
done(new Error('Middleware hung when client aborted request'))
}, 1000)
upload(req, res, function (/* err */) {
if (hung) return
clearTimeout(timer)
server.close()
done()
})
})
server.listen(0, function () {
var port = server.address().port
var boundary = 'PoC' + Date.now()
var sock = new net.Socket()
sock.connect(port, '127.0.0.1', function () {
sock.write(
'POST / HTTP/1.1\r\n' +
'Host: localhost\r\n' +
'Content-Type: multipart/form-data; boundary=' + boundary + '\r\n' +
'Content-Length: 999999\r\n\r\n' +
'--' + boundary + '\r\n' +
'Content-Disposition: form-data; name="file"; filename="test.bin"\r\n' +
'Content-Type: application/octet-stream\r\n\r\n' +
'AAAAAAAAAAAAAAAA'
)
setTimeout(function () {
sock.destroy()
}, 50)
})
sock.on('error', function () {})
})
})
it('should not overflow call stack when cleaning up many files (memory storage sync remove)', function (done) {
// - without setImmediate in remove-uploaded-files, synchronous _removeFile (e.g. memory storage)
// causes handleFile(0) -> remove -> cb() -> handleFile(1) -> ... in one stack,
// leading to "Maximum call stack size exceeded"
// - use enough files to exceed typical node stack depth (~10k - 30k)
this.timeout(10 * 1000)
var fileCount = 25000
var uploadedFiles = []
for (var i = 0; i < fileCount; i++) {
uploadedFiles.push({ fieldname: 'file', originalname: 'f.dat', buffer: Buffer.alloc(0) })
}
function syncRemove (file, cb) {
delete file.buffer
cb(null)
}
removeUploadedFiles(uploadedFiles, syncRemove, function (err, errors) {
assert.ifError(err)
assert.strictEqual(errors.length, 0)
done()
})
})
})
expressjs-multer-2e2af08/test/expected-files.js 0000664 0000000 0000000 00000006313 15213763722 0021710 0 ustar 00root root 0000000 0000000 /* eslint-env mocha */
var assert = require('assert')
var util = require('./_util')
var multer = require('../')
var FormData = require('form-data')
describe('Expected files', function () {
var upload
before(function (done) {
upload = multer()
done()
})
it('should reject single unexpected file', function (done) {
var form = new FormData()
var parser = upload.single('butme')
form.append('notme', util.file('small0.dat'))
util.submitForm(parser, form, function (err, req) {
assert.strictEqual(err.code, 'LIMIT_UNEXPECTED_FILE')
assert.strictEqual(err.field, 'notme')
done()
})
})
it('should reject array of multiple files', function (done) {
var form = new FormData()
var parser = upload.array('butme', 4)
form.append('notme', util.file('small0.dat'))
form.append('notme', util.file('small1.dat'))
util.submitForm(parser, form, function (err, req) {
assert.strictEqual(err.code, 'LIMIT_UNEXPECTED_FILE')
assert.strictEqual(err.field, 'notme')
done()
})
})
it('should reject overflowing arrays', function (done) {
var form = new FormData()
var parser = upload.array('butme', 1)
form.append('butme', util.file('small0.dat'))
form.append('butme', util.file('small1.dat'))
util.submitForm(parser, form, function (err, req) {
assert.strictEqual(err.code, 'LIMIT_UNEXPECTED_FILE')
assert.strictEqual(err.field, 'butme')
done()
})
})
it('should accept files with expected fieldname', function (done) {
var form = new FormData()
var parser = upload.fields([
{ name: 'butme', maxCount: 2 },
{ name: 'andme', maxCount: 2 }
])
form.append('butme', util.file('small0.dat'))
form.append('butme', util.file('small1.dat'))
form.append('andme', util.file('empty.dat'))
util.submitForm(parser, form, function (err, req) {
assert.ifError(err)
assert.strictEqual(req.files.butme.length, 2)
assert.strictEqual(req.files.andme.length, 1)
done()
})
})
it('should reject files with unexpected fieldname', function (done) {
var form = new FormData()
var parser = upload.fields([
{ name: 'butme', maxCount: 2 },
{ name: 'andme', maxCount: 2 }
])
form.append('butme', util.file('small0.dat'))
form.append('butme', util.file('small1.dat'))
form.append('andme', util.file('empty.dat'))
form.append('notme', util.file('empty.dat'))
util.submitForm(parser, form, function (err, req) {
assert.strictEqual(err.code, 'LIMIT_UNEXPECTED_FILE')
assert.strictEqual(err.field, 'notme')
done()
})
})
it('should allow any file to come thru', function (done) {
var form = new FormData()
var parser = upload.any()
form.append('butme', util.file('small0.dat'))
form.append('butme', util.file('small1.dat'))
form.append('andme', util.file('empty.dat'))
util.submitForm(parser, form, function (err, req) {
assert.ifError(err)
assert.strictEqual(req.files.length, 3)
assert.strictEqual(req.files[0].fieldname, 'butme')
assert.strictEqual(req.files[1].fieldname, 'butme')
assert.strictEqual(req.files[2].fieldname, 'andme')
done()
})
})
})
expressjs-multer-2e2af08/test/express-integration.js 0000664 0000000 0000000 00000014023 15213763722 0023016 0 ustar 00root root 0000000 0000000 /* eslint-env mocha */
var assert = require('assert')
var http = require('http')
var multer = require('../')
var util = require('./_util')
var express = require('express')
var FormData = require('form-data')
var concat = require('concat-stream')
var port = 34279
describe('Express Integration', function () {
var app
before(function (done) {
app = express()
app.listen(port, done)
})
function submitForm (form, path, cb) {
var req = form.submit('http://localhost:' + port + path)
req.on('error', cb)
req.on('response', function (res) {
res.on('error', cb)
res.pipe(concat({ encoding: 'buffer' }, function (body) {
cb(null, res, body)
}))
})
}
it('should work with express error handling', function (done) {
var limits = { fileSize: 200 }
var upload = multer({ limits: limits })
var router = new express.Router()
var form = new FormData()
var routeCalled = 0
var errorCalled = 0
form.append('avatar', util.file('large.jpg'))
router.post('/profile', upload.single('avatar'), function (req, res, next) {
routeCalled++
res.status(200).end('SUCCESS')
})
router.use(function (err, req, res, next) {
assert.strictEqual(err.code, 'LIMIT_FILE_SIZE')
errorCalled++
res.status(500).end('ERROR')
})
app.use('/t1', router)
submitForm(form, '/t1/profile', function (err, res, body) {
assert.ifError(err)
assert.strictEqual(routeCalled, 0)
assert.strictEqual(errorCalled, 1)
assert.strictEqual(body.toString(), 'ERROR')
assert.strictEqual(res.statusCode, 500)
done()
})
})
it('should work when receiving error from fileFilter', function (done) {
function fileFilter (req, file, cb) {
cb(new Error('TEST'))
}
var upload = multer({ fileFilter: fileFilter })
var router = new express.Router()
var form = new FormData()
var routeCalled = 0
var errorCalled = 0
form.append('avatar', util.file('large.jpg'))
router.post('/profile', upload.single('avatar'), function (req, res, next) {
routeCalled++
res.status(200).end('SUCCESS')
})
router.use(function (err, req, res, next) {
assert.strictEqual(err.message, 'TEST')
errorCalled++
res.status(500).end('ERROR')
})
app.use('/t2', router)
submitForm(form, '/t2/profile', function (err, res, body) {
assert.ifError(err)
assert.strictEqual(routeCalled, 0)
assert.strictEqual(errorCalled, 1)
assert.strictEqual(body.toString(), 'ERROR')
assert.strictEqual(res.statusCode, 500)
done()
})
})
it('should not crash on malformed request', function (done) {
var upload = multer()
app.post('/upload', upload.single('file'), function (req, res) {
res.status(500).end('Request should not be processed')
})
app.use(function (err, req, res, next) {
assert.strictEqual(err.message, 'Unexpected end of form')
res.status(200).end('Correct error')
})
var boundary = 'AaB03x'
var body = [
'--' + boundary,
'Content-Disposition: form-data; name="file"; filename="test.txt"',
'Content-Type: text/plain',
'',
'test without end boundary'
].join('\r\n')
var options = {
hostname: 'localhost',
port,
path: '/upload',
method: 'POST',
headers: {
'content-type': 'multipart/form-data; boundary=' + boundary,
'content-length': body.length
}
}
var req = http.request(options, (res) => {
assert.strictEqual(res.statusCode, 200)
done()
})
req.on('error', (err) => {
done(err)
})
req.write(body)
req.end()
})
it('should not crash on malformed request that causes two errors to be emitted by busboy', function (done) {
var upload = multer()
app.post('/upload2', upload.single('file'), function (req, res) {
res.status(500).end('Request should not be processed')
})
app.use(function (err, req, res, next) {
assert.strictEqual(err.message, 'Malformed part header')
res.status(200).end('Correct error')
})
var boundary = 'AaB03x'
// this payload causes two errors to be emitted by busboy: `Malformed part header` and `Unexpected end of form`
var body = [
'--' + boundary,
'Content-Disposition: form-data; name="file"; filename="test.txt"',
'Content-Type: text/plain',
'',
'--' + boundary + '--',
''
].join('\r\n')
var options = {
hostname: 'localhost',
port,
path: '/upload2',
method: 'POST',
headers: {
'content-type': 'multipart/form-data; boundary=' + boundary,
'content-length': body.length
}
}
var req = http.request(options, (res) => {
assert.strictEqual(res.statusCode, 200)
done()
})
req.on('error', (err) => {
done(err)
})
req.write(body)
req.end()
})
it('should not crash on malformed multipart body with bad boundary', function (done) {
var upload = multer()
app.post('/upload3', upload.single('image'), function (req, res) {
res.status(500).end('Request should not be processed')
})
app.use(function (err, req, res, next) {
assert.strictEqual(err.message, 'Unexpected end of form')
res.status(200).end('Correct error')
})
var boundary = '----FormBoundary'
var body = [
'------FormBoundary',
'Content-Disposition: form-data; name="image"; filename=""',
'Content-Type: application/octet-stream',
'',
'', // empty content
'------FormBoundar' // intentionally malformed final boundary (missing 'y')
].join('\r\n')
var options = {
hostname: 'localhost',
port,
path: '/upload3',
method: 'POST',
headers: {
'Content-Type': 'multipart/form-data; boundary=' + boundary,
'Content-Length': Buffer.byteLength(body)
}
}
var req = http.request(options, (res) => {
assert.strictEqual(res.statusCode, 200)
done()
})
req.write(body)
req.end()
})
})
expressjs-multer-2e2af08/test/fields.js 0000664 0000000 0000000 00000006506 15213763722 0020261 0 ustar 00root root 0000000 0000000 /* eslint-env mocha */
var assert = require('assert')
var deepEqual = require('deep-equal')
var stream = require('stream')
var util = require('./_util')
var multer = require('../')
var FormData = require('form-data')
var testData = require('testdata-w3c-json-form')
describe('Fields', function () {
var parser
before(function () {
parser = multer().fields([])
})
it('should process multiple fields', function (done) {
var form = new FormData()
form.append('name', 'Multer')
form.append('key', 'value')
form.append('abc', 'xyz')
util.submitForm(parser, form, function (err, req) {
assert.ifError(err)
assert(deepEqual(req.body, {
name: 'Multer',
key: 'value',
abc: 'xyz'
}))
done()
})
})
it('should process empty fields', function (done) {
var form = new FormData()
form.append('name', 'Multer')
form.append('key', '')
form.append('abc', '')
form.append('checkboxfull', 'cb1')
form.append('checkboxfull', 'cb2')
form.append('checkboxhalfempty', 'cb1')
form.append('checkboxhalfempty', '')
form.append('checkboxempty', '')
form.append('checkboxempty', '')
util.submitForm(parser, form, function (err, req) {
assert.ifError(err)
assert(deepEqual(req.body, {
name: 'Multer',
key: '',
abc: '',
checkboxfull: ['cb1', 'cb2'],
checkboxhalfempty: ['cb1', ''],
checkboxempty: ['', '']
}))
done()
})
})
it('should not process non-multipart POST request', function (done) {
var req = new stream.PassThrough()
req.end('name=Multer')
req.method = 'POST'
req.headers = {
'content-type': 'application/x-www-form-urlencoded',
'content-length': 11
}
parser(req, null, function (err) {
assert.ifError(err)
assert.strictEqual(Object.prototype.hasOwnProperty.call(req, 'body'), false)
assert.strictEqual(Object.prototype.hasOwnProperty.call(req, 'files'), false)
done()
})
})
it('should not process non-multipart GET request', function (done) {
var req = new stream.PassThrough()
req.end('name=Multer')
req.method = 'GET'
req.headers = {
'content-type': 'application/x-www-form-urlencoded',
'content-length': 11
}
parser(req, null, function (err) {
assert.ifError(err)
assert.strictEqual(Object.prototype.hasOwnProperty.call(req, 'body'), false)
assert.strictEqual(Object.prototype.hasOwnProperty.call(req, 'files'), false)
done()
})
})
testData.forEach(function (test) {
it('should handle ' + test.name, function (done) {
var form = new FormData()
test.fields.forEach(function (field) {
form.append(field.key, field.value)
})
util.submitForm(parser, form, function (err, req) {
assert.ifError(err)
assert(deepEqual(req.body, test.expected))
done()
})
})
})
it('should convert arrays into objects', function (done) {
var form = new FormData()
form.append('obj[0]', 'a')
form.append('obj[2]', 'c')
form.append('obj[x]', 'yz')
util.submitForm(parser, form, function (err, req) {
assert.ifError(err)
assert(deepEqual(req.body, {
obj: {
0: 'a',
2: 'c',
x: 'yz'
}
}))
done()
})
})
})
expressjs-multer-2e2af08/test/file-filter.js 0000664 0000000 0000000 00000003013 15213763722 0021203 0 ustar 00root root 0000000 0000000 /* eslint-env mocha */
var assert = require('assert')
var util = require('./_util')
var multer = require('../')
var FormData = require('form-data')
function withFilter (fileFilter) {
return multer({ fileFilter: fileFilter })
}
function skipSpecificFile (req, file, cb) {
cb(null, file.fieldname !== 'notme')
}
function reportFakeError (req, file, cb) {
cb(new Error('Fake error'))
}
describe('File Filter', function () {
it('should skip some files', function (done) {
var form = new FormData()
var upload = withFilter(skipSpecificFile)
var parser = upload.fields([
{ name: 'notme', maxCount: 1 },
{ name: 'butme', maxCount: 1 }
])
form.append('notme', util.file('tiny0.dat'))
form.append('butme', util.file('tiny1.dat'))
util.submitForm(parser, form, function (err, req) {
assert.ifError(err)
assert.strictEqual(req.files.notme, undefined)
assert.strictEqual(req.files.butme[0].fieldname, 'butme')
assert.strictEqual(req.files.butme[0].originalname, 'tiny1.dat')
assert.strictEqual(req.files.butme[0].size, 7)
assert.strictEqual(req.files.butme[0].buffer.length, 7)
done()
})
})
it('should report errors from fileFilter', function (done) {
var form = new FormData()
var upload = withFilter(reportFakeError)
var parser = upload.single('test')
form.append('test', util.file('tiny0.dat'))
util.submitForm(parser, form, function (err, req) {
assert.strictEqual(err.message, 'Fake error')
done()
})
})
})
expressjs-multer-2e2af08/test/file-ordering.js 0000664 0000000 0000000 00000002423 15213763722 0021533 0 ustar 00root root 0000000 0000000 /* eslint-env mocha */
var assert = require('assert')
var util = require('./_util')
var multer = require('../')
var FormData = require('form-data')
describe('File ordering', function () {
it('should present files in same order as they came', function (done) {
var storage = multer.memoryStorage()
var upload = multer({ storage: storage })
var parser = upload.array('themFiles', 2)
var i = 0
var calls = [{}, {}]
var pending = 2
var _handleFile = storage._handleFile
storage._handleFile = function (req, file, cb) {
var id = (i++)
_handleFile.call(this, req, file, function (err, info) {
if (err) return cb(err)
calls[id].cb = cb
calls[id].info = info
if (--pending === 0) {
calls[1].cb(null, calls[1].info)
calls[0].cb(null, calls[0].info)
}
})
}
var form = new FormData()
form.append('themFiles', util.file('small0.dat'))
form.append('themFiles', util.file('small1.dat'))
util.submitForm(parser, form, function (err, req) {
assert.ifError(err)
assert.strictEqual(req.files.length, 2)
assert.strictEqual(req.files[0].originalname, 'small0.dat')
assert.strictEqual(req.files[1].originalname, 'small1.dat')
done()
})
})
})
expressjs-multer-2e2af08/test/files/ 0000775 0000000 0000000 00000000000 15213763722 0017550 5 ustar 00root root 0000000 0000000 expressjs-multer-2e2af08/test/files/empty.dat 0000664 0000000 0000000 00000000000 15213763722 0021366 0 ustar 00root root 0000000 0000000 expressjs-multer-2e2af08/test/files/large.jpg 0000664 0000000 0000000 00011152155 15213763722 0021357 0 ustar 00root root 0000000 0000000 Exif II* ( 2 i Canon Canon EOS 400D DIGITAL H H 2008:07:04 13:02:14 B J "
'
0220 R f
z
`
| 0100
8m p
@
@ 2008:07:04 13:02:14 2008:07:04 13:02:14 jR ; . H P " X ~HU
4 6 L T @ v
@ @ N @ T @ Z @ z \ - 7 t ]d D " Canon EOS 400D DIGITAL Firmware 1.1.0 unknown (
N N ;] ;
p " } EF-S18-55mm f/3.5-5.6 H2162165 P
" l>
4 c6
_ b4 ^ 98 q ;; x1 1 1 ic }b 3 3 h r r g P
X Bpuu1
a P
%u 77
77
77
Z]C*qL'dl TX p<cP\Th M Y }
!~
A` % _ + % 0 2 # ( J 3 $ ) : 5 2 3 1 7 3 / ( / ) W ; J X e V 9 B B D > > > ' & S Z k : < ? C J H C ; 6 4 1 H d 5 J > d * F b B [ & b v i r { W b m f c Q N e 0 L p { | p p o E + I 'bx w { x q p i , T 4 M % Q V 9 B j C k ^ k q ` c b d Z L @ J & 8 c t n j f = ' 8
(d | j _ Z P ` a 3 ? 1 N / F + < O 7 q c f p Z ; B I ? ; . , 9 ' ; ~ J R L I ? < : " $ M J J L Q L E ; 5 4 / A
M K
0 Z . 8 X U c @
x ,1
Qu `s o g>! [ 4M * k k kTe k T a { a II* r m @ F
} !1AQa"q2#BR$3br
%&'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz w !1AQaq"2B #3Rbr
$4%&'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz
! ? ##2:@ 9v=S2 nF($g8Y
-5?frܟJ )㜏
W{ )$v̈́w HkMO-ԏC]'*@^憣p: v )p: A
rLZnqSI\) n / 8K[M4 'Îݩ~v(K+}ˊpz
%yt& ֊U'}{ ݸ$m`H5.r5kN[FѷR *rp7wjtSOVNy?[ :ߡ"6$h ѓgqEWЦQ@^R}4Q
ANF)@ǎv[^D_ U5?.@;╴2 f6~zW{E(
{ d?t R{Z@]NNw {)% (\sS:4??N 7uv1M/v-Q|mAI= d~Eł]3Frp
Ҏܞ{F ҡڪK.r }+DC7)](ۂ xޚ ۭ4JyULjӯҘI# R{EYz zBQcބZA;q") pjt4G i!ze%
";38iJ t. e~n҅ ۚ鰥dBhv""q> . YXKh% sӑS 7@)-ɲ TXS8).Y"d`=~Lmwv;~S56j\S㢯 > 09 Pט 4g>l*ʾ܃O\v݇(m,X
>_Us 7.:ܨ=N >*zr r>h:@8^ǵ8 >c҂89+zd?Lhr8=nߕ mG ;p?(돥 rT>BdtqڕW'0:s@p}RPE PE PE PbqGOA@!xr@'|( '@ Q_Y[a^OOtgڣ=@qpT%E](. 4
p 2:bqCL1mHm+piZ<ȅʽJ# .ߔˊN!@[@D(靹 ~֝v1a3 m J*l$ lQ0 Gmn6جUrq?
k(G?+ vSOE#? 1)x®oΠC`zCn&[A ^:Tdr+g4*!,2r8r931a9f IqګN
njvǦ+E38ky 1bW9c4F pP}s[F*$W69/AЊsmR
6~-o!8 0Etbsbqi T-m4GQo Rƪc[VP7Q 8U7ݖ2\Y - ^NU7"+ҹX"#qs\^K ʐ mr2ҏ̹m^
=3Zc#OPxj$Dh m,vlݱGO) NA7)$ڀ#n\vb֡< d2}dg<O) p Vww] &}n9 H;z1 se 2O
x;J 2{h(lnTp ދt t А=qX 7U)4 ^^ę zVR5ب% w rC'4V֯slnuWZ$E8㐸ީpxau?Q5MQJZN a(mLc /O0ڶ~=|^U9UnN mELݧxwI];NV( G
+',ut9۽SE:$q4Y>de8 v{ Wceyu.JVV?3%*x?noUnߑ?ŽxUM6폆%֑}K ?)4Lsޫxς?ki<j6[ūJ &ⰵ+5k8Ii竽HW %U sH~jp@.;Wau}WT˽OԈw*3_ <-'7hAM Z4mL`7"d>"h JiUT-
U7}om?C af,b-d+ѿ]i &R>e
7ZƯ]O,WBF#*7 *O犼eux'C]{_WЉ6XqCҍ 2rו=98c%J?RV}>%A ý{֓iwUzzsZm v rN:b L)ٯsm 0|ۛKA$!_8+gؼ<wKnkM\cQ-c7/5۫èϩC͕ry7qܢ\ G {ivʗVtzgbt%`->l
xa3 <7g>gû{#G3꺗n̚՜~ {[KMQeqf hV]a-~ X=׆(4}Y-Y;+ 3@89#yu\~:j 7U8'mny:h!FNOn?v}e@%] eo6Y2qg~?[]C.sen/Y^2}]NhNULp3D0*8FP(ev}Yjqt*8T"ivXj, rVKlxk4/4c,Ua*GcڽlUe^Qn +\iʢ8;W3ګ&q ,zg_hڈV4`BALd,e)bdz[˖ nrz ]oycN {4 "D`9!p? )VR\ ps_W7>~ !Ԡ|7^͎sZ|t;mBuk{URr8%
bMLj5 kþ27:
j1- "`'R)`FCf:o$NWWC /+TFϖ=x xM派"MxIJ؋SLlqo82>qώ?-4=K -;W ! IUQxuUnz/"#[)҂2};;~Qz]Mᵿ.> J rkjDռ^]KoV\v䷴uښF צӃnLek_z ?4; i~3ZN!xgϞ)# c
ڰ`u$_JlN:{XBe5#O[ Y;m8yg' R' 5> wvTCLކ4.l0ͻ3
jڵGoq__jiD.p}Oic Si6[G:NQvխm$$ﴤUZF$}=k_N5KG:*!|y u+Be4 p9?ŷtV\𥇊 *x5gӖ_OGrLO B$
09 ?t[W\wJ]^+G'ھ;5 ʫR\9=w 'W+ѩz<3V:utFݼa0+*:,䰵eVyחL\B .
q;3L?iֵC [_54ķ\?|dO!ۓx^=*E 8i$V;⽌MЦNg/'$:>:WoF_=&oZWu5ԴkER ij1UG7y`~ oUP ج$ q,71_z^/ܵ9زRMjz,
!k`{`u@o37 }{n{]$xv `*oJZ_yQ{9ǒ*Pku9IJV$drmLFvQ+M1dM"&*xG[[;wKE.^=k
q*AjzIʔ*;FX ϱc3:I`Hw<RNODțJǣ.6 4f"m. \[F1&tWe?R]i͂4ΦHq
cy9}Qpj.}/u*1xjZvz#F\ xN0 ?xrMo[ݭ=ƗkLi,;GcDgח[BxZ ~wMwMx7/(YCT֮t@l8Jn'[y A ?56x:-Ϥys ;FX }e-ӓX Wp %*WF:?+'o8i{nnG
ڇ/X^[k؝qoӵY.m1Uwĸ>\*#|K;Oӯc`0BcAy1kØ,*vjKM3jҕN-Y 3&t˭Z3i:O1یV˫"r墅dwY3i< 1' X_[i֖ڌm 4p] ( {]2+?来!Fٞ$D+.mn|f +*IIXe$l³AYӨݕW DB
7joͻ+N[&7ۡuym#d{#w S_Sr|G~\5NJ5o.(mA<ןV7
4db_^F}4xZDwki &L0q\}_^
;M//"Ŗ-AڵOJ6_s֡:hKr}z W2?Eiq}tDV
NiRݫ=y~?F㯈V:z? ͆%pj
8&ۖeF@ נڸv1E 8I]=ޯ"Ir]6n#RI@6 9g'(w"܊/StZ[h 5Кfs٤"Դ9ډ,݅q7ĺzmo+5a7 nJ4a)YKN rپ&o4pO}{沄qXMcu:y) $2Bs Z%y;$AF:%L> kZZh:|
Lgd c+ N/tg Jy2=y =k %
U(HSp}~cTEZNd_]p[=+6}gKR5y5 &'GOZ(a[Ncv F+A E6Z 3ޱpYТ nA8bw{ k^Jeo9tOnagFQ=or+km|Ϩ~GEtIeӬcKPF?.w +OY$=ܳ`6NxS Ƭoo2.,"8w7zN$m"Ӵ;pIa# jK?қ:YM{' D[Cp g,Qdb ;MJN)=OS;
qr۲3/uѴF5=B[RK ug1&xf&GNxCx
3p^ݤ:G%Гtr ;X<_V *kFV5kZ7.
c]F{maiDU!r⼖/ZB@kk4にT̢bJ39PM)|tV9֮4+{m;L{])ڡP? v-~_J\-64 cj{?q3,ێzq_fYVjq VQ;ӷ ,s r0T34%fk ҽMXS
Tc sֽ' 3A Z ( vWNOSkD6z]_]t ip3~KWmd#jƿ:Wq\ymmoG&$fcM^xV=.-5poX
r/_8q.~J* .+y;2":d0k%D`Vϕ"1u<SMI;-.$ fM~YXKD% |mZhuͻ~Py )
v?ćWѝ8EaӲ 7(V0x+}ݖym
`.яj =}}wÑxc
?K }[T"rcJc_y54ZKqWBG)]j7oZ\ē/,c[+$X
0
Lqk͖O\vޟN+kX~, =|6?Z DT} (U\gSKzؤ0Gj#!b{3`{ԖVרj:2mEO2KGO^ط%RvŵglaMfI Voo io$wu9?%h.4Un S3C vsItV![K{qW=r1]XjфMEoAR3/+#Brw
+#R͵s
m\֤L OzD< (^Gn-%Znjux4'BZ@LG+/k' BzDWvgwEyaN.1SEs8V TEԎQh44kobmJKY$'ck> mَ5/K`i畎JirJ_mAMM_Is_-ZX[7Qj
SL.F03_kZ' ~ յď2~^<:g :Sh匡 .kWvwjz Y)ķfi07M䅌^W?O\W 'xZž9M<:u*H9 $7{ub(~Ii{%M5 3,=|!Ɨ0[AwI͌H"?U+5n;f>JFݔ 5XE֝
db6aF9`w =xPylNr5i{[j G88ni(N=G-@aFA<(}
i#|QqYC>o^T`﵁Ud$݂30z[ ` ։+- W1qV1$bj^52g_ʬQ9?
^6KbX` #>` c4
H2@<1Ss=Cl('g h 8S+q Vc$å`k A \ p@>K Byݺv8CG+q8BqzG s@,!s$p? vr0y R.xq`ϨApO49 ߏ@;dcڝ@ Q@ Q@ Q@5}
휓~~;v דۏ@w 14:ӑ1EzLnˌ(I:tV` A Ύ~KDƞ`.>9?^*">U
43MlB|:/֫MXy }A)G# Qq[Dg cn;]B9uR~Bv %~ڢsۻ$'W:- y;@ `
z-ibmʴf~8$2 p1V ^+RT #ZHUQUL봋c kѬ,h?μ ]9iaS nJpYjV%mڣ+95%$@> \h7ݴm}VUqr:v:c%_&63#54wĝs _LwJhQa
w !qeϸ'K
07'R܃ gpp38ی`q X Q ϵUcx ^wHW-VF6d뚕7Ig?C_QГ^2$Vvz5hn @*A ێI`s^.uK8/_ڷtU}wk߅_sO[xiZ֛궖^Ec,j!W+е_ 3 {uy<}?:xo-ĸQ@9pp* #3$k_sJ:u?i
rqZ4ut /¶ ~
6AզkeqnfVBqFX#$c^e={I s-Lj]<9wtbk}^VUUmm種V[R+
#{}SbpќQ5_S/Qg?O ')b];GD:κ32 S⧉5o
9yZ:S@O&pV|,sH8J(Rp#wj ;Zcɣo}F4z}$x6 F{
69n#}Z9 g sV!Λ {D=̖#`4q.TWq~ xiټ=Ik1^ zmd,{q,.>Q\_hXXN[Vz`x>g'ڕ4v6FmmχK9T6EAȯxX@}TYhS\!(A4f_ >/Tb8<[Y#m"VGDݾվ7Q%A_g帺WTؼQbk -^ V@Դ5KXfM>@0̠H]5|]jhj:ł|0\L"QB_A g:[nWyK$zQX ,Ea֑j~`l/4K]B%a_'Yy3k
Vh ;[]1g+qOE#^|Um); ?χyTzۢ:Mf7i{]#V0$h9sp5?ѵ?hEeF' Is,9krW#?):ԹyZ㱝wƽ-Mwc-ŻM˰hc+mU rp+xJEng4äd6(`lu5f18]7^-H4t5ڕ{{DΌГ *; il,{B (qw#YxM]i6#Pzm ?`+YiZffV5(|Up6$rrkvo ŇVZ _wE o$iuM^!άTnVpPZu$IFI=d<&mO
ڗ5GİhB7
O_ S6V5_ >x$l{ 5,0GQurQB6Z.3Z_Rz)v~MKNM幎[x/
R0
aAJtk5]*`pwg[:JZnVU$@Ui)6ӑi)kl.7^8A Kh2|1 w 22+,C6lTƄja^'gT.Ex},`{ZY>-ci=\2 L&̑/8ZxQw '1hWzn}7sl*^?gZ|wn :c:Fz+Wo> 8GhYmj/ q,ȿu p+k:{!5aIu{tKNhHIv F
0>5ycϊMATVJZk}=-W\,;o0y38%egUqktG#HV1؉_=i $oi һۂCjN[Okq0USIm֯;y蚕s=3I"]X$/1
ɻMޝuq S.J ZaeN,,?x-_*ѡVMߢ=CR&}mj3-A%8G d0ݷ2FzY/ ii㧵-,zO5c;KYm(\B;`0L<:WQX6ɹ(aI^1\8jՔ{i3'iMvox/Tt-Q-GO M> m;
k^֡Kg0ѻı,I$:9ꗙRXWRmmڋ\^immLn4b92z|?UELM:*NmTދܧF$|^+XY-Ƌe Q (M#)C`2;Vvzƿ=֣^[esut8v xa(e)hΉ0|k v7oZY Bh滽I' v:E1JVV ΣT8W b=XyǖkddY7nipڧ@C&6¶ {ףռlsXVJt]e}#0 :}jſN[ԐIϥR攔Tu!--RvNcVGf84dw8gswu3[yBLL*X w=k|Ns߇
^¾ :z}>{ Oծ^HY$H2WuQ' k.hRR~j}v6(ЦFMOS/nu wr6 L:8(7e,&Coc\i-U:`宅7> #G"D` @8:v@UN`5n%zqVUk:nQ GC~!,/d8
&>>vP|J5=rZAsy ! GF n5B 5J}s/OJnH' brM}<9 F.2+B0R^wLJO&Wŧ- Bd僧vto(
_>j˧oiFEk`^M+)NyqӫY8J7m|^)ӧN8ȬF-5T]6t;=ܑd?ĸ d[u1 `yy9jҏ8R{ï54oxjZe:h.2@J,n`m8y_/4 /Zj%Heih# :x|eVROWi-4KƯylgѴ-$AZ Wf`~r8 WI`"`y",8(a#W}:U)ƛQ][] I(Ys/>/t-5+[$ndoH9
6:ƙi.Q5E !#5;<5jXi5h|F}Մ:slohu < !CFgBr3]~j r]Mg{% ii'$MgӨܹ͕l{{lG }{^&j:pY>y*.8}ei##cxNB]2-
s< MF[xgU
:x*ib14eΖ_aZZTE'%[5#
u>2X5' zʞ! ]L+M1@H!jww$# ־_ TW^rw>%9rW 9s3bI: j OR$c빆 Ԟ :Z!ιYx@AFO5=ėwr!cV66 oi8[K 2N1R[X z.9?tC_m-"ԥB/ p' { JO42 {f+4xVݢEΘ
\H
Fh^#MB1{TQ"U$`3p[ u ڎж c0gתx V⯳CsbI"*p2C\NNIٮJNݗzo t[m/MKkij },ʰ 9;O^.)5iarx\3W0zx9cu>˙B>xJxSMCRM~%hM۸& >ML.R^UUS*G{u f_K]ZfrN3 Iz| 4].bMrs%˕!W W[Zj,1^P%FH
1]Nxj1=^ :U{DVg0}wBt 67ZPe6__`s!ʰldbiSB6m YG"391~f$zX{dѓC *6ln=
܅h+Qd )'𬤕Z]9 &qOQ}kQ]
RK:``1x N RVI5}G|0$ v cRwI>_/OLӂ3tOC݊qV(?w??܁ ;PI $@rN~]7S++k`Wp3m鴀G5
I ih |#B[^ v7' 6 ӥ(@8?qa'u cjU%Ho# SN>Ij6֑A 8
1cԎKUIԘtd*t\oIm} N~ z`fa臃>e'3 4#u< x6tRӽYp hH 㚤֜WЀI
a1-LSm?u;/t 9?)ǦE;FWfʿ*IDp8 ?
_{( 7<~I{1mZcv #$ 8ICO]HFQ vmRzBvA TEN#$;.+k.8nHq/x#]ȕp,3ې jiP
O< *v۱ATQFqM8"m}7Td
> 0 ^UFVP/qZi
Uۡ_ƝݺJ pvÀȣf:gpR䬢({
#nsۯG 8a +j'k
qTc
9 /s[ B'z@ (=.G
dRm+jCMi!HPOS ֩h
I鑁Êp{ZL/s a_j Tp#z~TӲJ q' S }穨nI%} (>ct UO9
Mt[R+ 8ny ϭaTyok3QOrp
rxfX❶ zE81Fi;O8h{}w/ˁN˃t
(@ GLSԁQw4Еp6@PNx9 &08A4 e 8<村?: Q@ Q@ Q@H ޔ#~ Dq8Q6wX F8h gN@?tdv] /B/<
AN)ۚϰiЀW \}+m4خN9 j,`w`PUVĻ
o␜7`NxV2j4yT 9QF U]wk0Sf1} ꗩ7bHXH)QrҌr=waM;֦G3QF{VC*@0=M}> jy*S)x<Pی` ԭDqGwa6{< =?)0'=_4 `Z,+N,08ZO,dkVHIK OZϔV0$z{-Ǘ4.n\]8\8yq)9Y: 4+(]J[h )S<砮|B800{ъ 55gӱA:*;uFJEKH C @\ s|=J.uv9 ;`v OA˷vG˻^4Jg~Yt'#ׯ,.|u o YGV*OJ G.[iz3xjhtUYK;Jxn F|qO<2rRIho ]UWjCĹÒxkZ#4gN}SKy-hmk[
ygLUWI$ֿZ> m'VqOhZy\5$HlP[Zxj˅! [R=80 K]V2|kDŽ>+x^qޥ Zrz mm1` W
,%:sEgs t( BW咊qi''9}W6 yM.; |=0WK$Eq(b,3xԾ?;⋋Y 6;K;k:PF a k#:`Jd~捳 .iTzY>=UDht܈J"ŷ͉p9Eō̓O%(* #"2Ip:|}匜y<8<:umx x^W/H|1
BYn㲰ҭ
]qu^UEp ko |0Kú_guheoh|&YC+Z30澳3 u+>(4I7o9SFUJW|i'~, -ï+M[HW]cy Ď[pLN_ŭ Xͭ:귑bt~8m$ 8uXpe ^XUMJ:]=p,~ "òTkQo%smy(Pϻ!N{W*z(ZֳpJ߉& ѹŤ#j R^2:叿DAZ>rш3Ȑ@ P pJsUZ}J]_Cm]ZNѵa
XRKI- {ý#DbCy 6b RK '#.\^k_QյWkwN
R_Mv<߯j6ZDI[ smpF\c#=k`.5JN.-V(MU'Q .Xz^jKim IfX\JES6y 3r N2eW, >>f*p1:Wt:Rqo
3OYz٤^*:GchEk !idV`zsrk4|S⫅A1jW$vP:q\:>aSN &k;s{E{lS_y ec-d%ꣿ^j,KF8 j|(
n_ud)#ѵoWÏ|0m4O w!zMW`q#E 4;ÓGi5QT4i(܌ (%7WV*sJ1WJI0WGwt_~kb/լaMW $&e1xU%J{U. @wSd.wӭa+o>iZfC4S.89b#J*4G_7,T]g9ӌy,5[M S:mkԈ.ihWD/ @\W)a'> ),.1,km$ 01sJ;n
nN7ZzƏ,%V <| gWu -gD*eF p{V9 FeZC^ܪk8ʜ˄sM}v[ǃX4lu\ߴ s
.z92* 6FҟV+ m־AOZz
i9{Wä=f}. K+6_KnT@ݜrVKPu+gU} DP-.`{Eӛ{0+*nzӲtRANܷ9I?s/Uϗ0 Cc'ozøk[) ;JR7yԜKdXycc~eJ
?Jce'ȓS7ʥw{&sViƤ, Ef:w mvu3ɞ2|0mtXҥڨd)s(0jW2q#y}k2P$FoW`+$sϿjU4\TЇw e xM%G Ÿ umֹ]O۲K<'f}
rHJz%
V}"$5Z "ԤԮ\؍2rK\vba3ծ&Ba&MP&!M'v_}RMQ yHʏ3Xiyy<6)s=뚄'Z^3տRU.V050.&TJ* Wi2+l I?
aI9%RpE (%dMC +y!V4ǑF3rz%:kGKzozt$PAqӜP/";
.?7cU;t 䩺q# LH+ m98 ֭{a- Y7Wpc }tJI9ӝ)z+̹#'nңTYr %` (/}`m ?:][X7*xw Ku@[ ( :t^Uvn*UP &y|#Xh6wn:"QhZdlPG >}Aާ=N]tVzjK/ޓaS\kӓ,;V g$7"y]3>bMO=jBJ& vzCݢw֗rA
u$;|Ps{wi i6wZl:+q f<26Y8V 6x^% ?{UjES,vxL
*;e6f9,XoRX
2] 1{C =\hMYw7QVJ1_M iclzjC5, ⼂ۣP|pHq^e
sIʳ|,#pػѓJ{k-arhUOκ->)t#nf& \5:NQs6hb&0o7 %yOCuSݛ^=^JB=Ғp1 : ,c)/P-D%M۩0y^M߇X.msSN Ao.i0WQ[a*)jk>WDJ>(? P 5g J3cXOOD(Ko>$mFQwG j#88 lt/Ú (#˶TVyC2I8R5G
*pOGURN;]?Þ']>9 "n 6ysM O*{ݚF"_ qKXՙq 5V&7tV$6F2I;sӽtz.cq.8;ؠQ@Q{ SRZv0
VxI:^TҴوvXd#>D@袽Lh73c+wZk)JF( ? l|)/n!!'`71k!߅ԵnIt6% {ORuwdۂ3ds`!*uk;=GǹS'y;|-v{ 2;Y.6$sc5~i ʷJY& #}_; +K\ݽ.Ϭ&̊?%Y@0#hY :G c{槂 FJ T)& ݸ3v=^z:1/zt*rrG"nb W[xcijxKCp&-$_0s/i5j
o
)-:X2@ܫ^{ }' .Y_C h*i o~SܙmseI8 =eM,Q0'lm$sէ:\!B64Ht#V1h[T r6p חGJrpQԆU}oGCmOUQV' 9P"sƫxjZK5ͭc%=|q\ƶe*qohDy6Ocp:*Ġol A*~QМuQs^IRؚ[+{r @*ؑOP(:x5Gbe)S6aZK,Zgu%rK8xӮ= 0+yzsY
+EJ+m #R.qn!Sn};Eң;} mmb K/9l #XxsD 僪, @xp w(|6ۡFx3ڷaKi5~ḳi`Xܤڬz4%f{8ne,V TyU8M=:**ώ A/XヴW_m~M4O-;oD Hn'{tۀ9 Z1X< #.yWv3MY[?^~3
Ǯ]ͤXחWw#DK;C,`J
~ 𧈾'_5n
"O# zY?Fr^Wv3 s6;1 3oS"il4Oqpe5v3Dr3ֿaӟ^+6+իMb&k# YUA 1w 6w!jIU Cs'"*7qWM w88*cc {WnSE a@ ;u?J\sg ΕmVۜR2>^BEW$ٍ}sH*2wa%76PdNOcJ6*c Rv
B 4`X(֗WVay 14Ə ƝDȈrWnzcp
tHQ~ǸaQCJ循aR l``ь bat x )n:QnmTdn) `@ӌViZO((H h*LpÁOcG]1 0WGcRzm#$A)N
I j t?+7pӞy
s۞Z 8Uwh/A5 /`9 8qsUVC>]mR2: {)@)nhK6vKai#! N 7#`;g Pb B;-<ʅ4҃$*RvV H 7.t*}ԮBў0'b`qn-+ ӓS{Q^!AzcUrY l?>B{ S ڧM)Z|c"mN+c sM F X.YEDi\ ԅ[prr/xj){qq u':qIW#m!7@RyJiQ3 -TtV 1LсiV@$)2B ^`kH@ z 9`á W ަ1aBe`788 * zQO >t>`g #t{jZeS8 s8 0ߝ&E8h) x
=VZr]z#
8pOsE&mt$Pr6)bq/B8 HMB9$~
0?A{bN1ϡ=;0#>
'R ;U
;s 0rGz 0
*0}1@ߦ)
Z(
(
(>_~ =' #OE銌`W![q a) FO $b#(@
c) dd 9.1SO v ڂHr@
B0= {Sq^CHߊ꼊OK#n$}GoƘ.1qzwkdDI6 y
9 t5~j6E ^}3L'RWBZ+ҡ`29#j-,+-
`2֡\*~ZԉW.|##:
80sVMo 9Br4ealS2> Q]6;xRT\t&^%U0q@ Zs=Fx58-)=~I עJǝ&գa@ Uf9r;+cQr'ͶLǥVg1$cQXͽ5-f+ cV i:'n7As tG?=y;,abM!W_V\zriiU]F qIm1ZQrJ:(ŭow:jyj: Rwm,{tt4= SS@^;3a>\>`
R9! & t, I=9ɠ$2xq@ \tM$pH`29,7g<)' &9#*FBp8M; kX=, 8s Sq;})(\ySc$c8bݚЫJ=(9S-6 3K=ƇX$ kugJ@ 0g;H6LE{JoHC;dYAGU +KgQp?y7~-|\ 'z`í
Z o|]完eSSRnNp1_ r=[4%acOo6ݥs oï _i7y1Vr+Jpr
w ,/xN9.-Kľ)QE,et7; .3Iz̢>+9^E'wq# YKOy=?$q߇u=htٚ/G<)
} 6%axWo> !o_
[vQ69U 6 9"8LRsZ)ifogujXhPSיGmo <
7Imn=[ĶZƙr4yZM:Rعf_a!yUπ5i:]XgIR5Q WP-^MJ c5R4{ub&n8g*Bm+KitU!Nƚ%/ccmH}P 4 `A9o5~_ |'ZA
;9ُ+V]Z_IKi)sGT(:xM KSVիѳR~>8Lű&u[-ռK($fDe^k|u(u}>o ˂] =Jo;M'6o֣jVP骔nucKI7Ѣ|8 h_tW 3|EO ; i>^KEt.t[Xޡq414W7q*Ĭ8uЎTp= ɳjW + GiE_wGҿ t2G43|, -)aHFNyȯ_ς5$K]
FJZf x}4 =x&AmNFY76^I s_+b R87ij~B +ֱOM go}q mdp/~ͽw*`39*XjNm{KѓJ3җ3JE;Kj]xN\ԧŌ0AKGjKj(%~'. _K6ZV60LO;rQo]IU\xlpR,tԊUuە\;m|{ml&e c:tTq oo^0}]5M AHҊ dGcw"5 #^HWT,}+{SX%䚥|Ic jR_y#2ykX́
p:hկ ڤQO#,/ 2VY B_-F|?i(o4CPM<>^ s_& ȭ[ǩ5ɷFnBu t1 Z ,<)6u~}[Ir[{x.j
y^DiEva9 Hoŋῇ{⫓awmkx%g(2sҖ#9.vs^+.l (%g)|_{%xy^y'rrX}p
+1 O`:zFZV_#YV+B#T#7 죲0ۑ庵c )9tCa%Hc&E@$sq<.ESV*D^Cy)'4
AQC0N:[)im,m'&qx OzZʥ?v*ښ)r%ͱ=\K R3?O}ElAR(%EV, WԜWGk-,\ZN7b~MWafbX`~gZ{ݴ~Lȧj=ڕi(a긻4^߈T,9f] qq|p NβG%c EaAP2G:傊߰>9ZvcGh f;` f
$ā䯵uŮn[[n)|" lͱ' '=+ռ[Mt;" )$ 5pr>YǙ|:cM/[,hMi"ũ,|?,UvEFX[5R"JPD=Rh.S2$Ѵy~{~=j%g@ O"vߕXQt1h#ޑ|
7 ZVZˤ[N(PbHa'U\t96M
3ĩ/e$kK"F^Gcsfr# 1f>e!swV4i-{7'-gdv^ ,4}Z[|#O'o]P ȮBbVӬ~ʷq:J(O1t³tݾr)r涾{L|kx;Z~ۓ]4Pg"]@%bv\`U ZѝjtbƱr4o x YV'nn%oZhUsm7IBqt5a59-,zYyWd*e9Xv+ҌqxsEUOjibCDJTpy%QW~}yؔIYC
F=WĚu~ 6pV@92d$We$ٛ9qxUpӅwoqք*ʭKN] 3[ϑpv0>#Sd
($@ zμD~NN:E(2E<(x߭o{{O,v@#q ,Քa=뢤}Ӳ}D>tiy24lT>m9tZ=6Zd
-=@GbFyx] ErxfkejOp7N[df8;ȭ jxWյ;c.m<
g[nrZYop{%l+aqJӔ4+o=LX^[}cÒx}?!XSJH iJ5|9
gi$ m U$t_,Guw| ;md
@SlUxJem{/T[oPܣv{ j>/^ϦxJ[mWP,,O2[7{|m/VlKS5)&I١kO0 {ҾҧJx)C{_Mbz.IKmm8=WOk
ZKJ}oq.J9l MaЮIeـ%2
C1a8ҵHCG{K|qZ~o`> 72^_}(K81z.nei..ŝKY=J-+v4t#T
եcApEwvB4iڈM2cT+iV LWZpҍXItIk\F
4fCԼ tx;9(-oyc䢩?r|~!o;x2]CgH- !dd{ׁNcckQC܇[nsm+ vcYB @˟MO_^ ,
G٣։ A8ͫTSZ[TUi),ݟE⏄vn/woe _Ȓ kR)[3Fv{ ?WvRfu
~+pj7VHFDlgDSK5
f JOPqj:8A-^|vkV^XAB]w2mL{Y`°1LȪ1kvh|D?G>ͱu~Gԧr \.Vv1ƣ
;VՍW]iO *DbIB%Z8\C
Cz=3ʱiWS~l)8ׇ4G_5în7O4ֲq2yy2PAcINR|m(m 9r=y~x[&+9-.їQ[ۏE}3L }1eiPEmO1[i&4W]JHcY3pI-Z+Bݮ>u]FVHoڕy7=r^K[["{|@f
G!mB/g]RHwlȤrK{W 8K2ĪUm]==qPKݒW~DiG6ETg +|#B+AkdM5ʹmr @N[{QJ8NZ_֥YFH.' 0" U\./cn1"Bgnf2aV-7vmkkz拦[ch"UK{8cH8@C"'Q饹H>E 좎zty[snZ Xwhg( eňlU c ,zG]l3$0 U.rEalz
wk(%7mu@pFL]KW PxU!` ڸ*B0s|SVڍ GYZdax"Wo ?1gN}jǂ>!_:Μl>͡ uȎeg ,3kal5J'& H
=N~ x\6WΩ
7ǨO Z7 ީ
OU/eU˳1 2jpy jb\ҜӏyKsٴ} N Jt+xFK"`e]CMeakd {}֑¦'`qp\{Oⶻ!$C
y<)
zM[J&KZ+ 6Fp|
rzq[1)+s; &fۄgZwW 3X|Iv{)p0zt|}OY\OZiz.YI_R;)oT~Ui m*֍; -e}2
:W( =I5Av2Wc<
! F fFӵ;Io ͪ3!@LTV\:^mܭ4 Ĝ"G`:V0R[i>MG/T azuinNszk-oW$8=)vr8}=˟x 1J9Fv|Èc Nwo]58IFsu Jz+]dm;A
Rn@#8CekEnTbTW
3?fe2_q~Q.
4pE>T)Є ) s}0qǽ-ovc(.FqrA ˸8^X(\`9T;}~0F3^0zc棕GaFJަV۰Sqq[%>=ip 3HZvobT$@ 85 〡q&099=G E $ޤ'b
t ?Ueؔ2ԋnvd69\`\TN go |ީYX+Iq6qIdOtӕgk
(ۏUQxI )T=-5av\
MI
E69#!x*1Q2.qcR۽Ћ 响u.; 7pqp_]ҵ|֍w~j@ '4avXv: R}L=o{*zS-?=
zT V
)ja $Үwc8:èqjeq|r)]=IqG5q1rH;@IGbgBxP6ҮF$җHs-9 OL y:m+ r4 w#I #z 5\H@~
hxqdgb=`õǐr@aSא|Z su=Uc=3PE PE PqQ 0,xM $gF9v17# 0 EInz}ۀ00p0I=k3mSwvݞ;qq@0)?/ b@ J5B_y;A4p3֒za2@]Gi8 SVv#l
ש?BCes G*_hEk$ld`dQ+E+dGsxAMe
8RJ+ֱu 8 #I<ⴈzhBA H%I L9gWc ֣~Td&{>r' 翷_Ҕd- ~-9&S )uў]ԂFwv `?_+${i{6h=ҥ,ocϭyX G@ ^ ' ]?AМtr('Oz L=F~( y?w ̎ m[J3FCpcPI# r|Ty<|u 8'_M-0#!X `v*":2 ̽~qQ[
7(^ >|Ǡ8%Fyq}jV' cnԃh!vy^ײC r} +vϵp>(f v gYC']vV5V4FkB*kTt}z :xo)7t"]]~u nj 2G?x[lW t (_xH)>m]ful.-g "~=ׅ,4^Y*[߷0pHFbG*x[[ ԯ[/aotb{ ȷ\plt"b=u=&Cͥ&xrR : 5tiwf
kBViߚאi~4q[i#_zeKics\GR ¾JѓL/.l/ ;/݀U}F#a
wr_VzTFx+i'fS ۨ~|9me{sp0dx< g n5)mӡl`{nUytq'Z%Xz GggSZxu1\*Ӻ}]v8: e`m\Z)R7f8+jkD nKb< ex .xzWױzZ+*+ܾG~-{ύ/XK&?gR)d#or_ 6>d:w!<3J _y<`̸ 0s_kOR2JT}`'}#{f ZJU({Zs;*~Dh%A-2 (XnԚ+[ឥ^*Եإ,Bc % r,^wia^21tJ+=\|n TEKm(_[ ^*g-fMNAx3.q#«
kGk/EMknZ;=A*2|i
|&*,zͶè|G :5ZVRCF ' IkNj,Kҵ*}LhP;Y\ϳ#˝CoȮzjVרv_Tq*Κ~{^:m%d"FrZ0'}b=?B]H#s:p=05Hw^zjyRozMK SA>seA)Z#M_^n y>[a8;pzW |7go_ ㈥x{y|9
mڕͤ߇842hS0#>J,}Ix\:afhp.XS -Z<>[ t*4Ӄi[|aI4֞3K]jP30i$e6Љ0 n Z'ei \jk}j!6!\ sH:\ -Xҟ$] -J6}: _=[feKWCl~C xSy.f 9݈,# ϐbqTzj6:NkMZ*oonwy"cn~X݆J3zFϧ\Cgp&E 컇C_SC([=EEзmVH_*a {P@6;9B}+j:ң( 9SR~ hhpUWmm- w>n{d*m?B>/f,S0s 6Mo=`$?w`'Ϲrf67W?is#AΧ}]"G!Бe;J)b'c&Ɯl:7C jǫϊI\ap/,ՙ}+WԮRR-loRV Ynu2U y6. 8jriR{XN1qjWKȤC!up?J!a*`Ock1Hp}kդǂ> VgR\_['eF!bێV4˕kqNR5mKI--Vvrػ/Ǹ:\<1mK1cr!OA8?uKMBIe #Ýk]fŢzO]Y,G7gKk4{cK.ؕ1`G" Ve9愔`:gˎLS(.$v Ս| Pm! p9ֵ¦]Ln.Сq-DG$~WxZfǭE[햻K};OsfYc+KeWi Pjvqz vG/I{m^:ԩʜRj_i ,u;GkBaB8? sZ]z[mM/_QmR=¾/cEkm
c]ܐ ^sgj-9٭Qpnb'=3^; FW9r+~< :VotZ}PwaCam-{p7D6rq\6sϨ,?*(&nt\N=6c Fu%Mrm '(Z7O-W=GN&
5b
*e-fD0yPpY wJ:ZG[QTCu 2gѤZDs$&ko^piy>hVs+Ѵ[hojQEriL13NO d՛h+Kf_>6۽߱ sQHh2CRA ,1h54]Z5'>E{u% ӭOƖIqW$5 ƭ}w^}DƗw Y#j ⾲cBY1ne}~ο
x8sn,G7˩g\j.חXth 8IU. yӺ*Qj@ظ'׃jt:mi~l|!kygydFBe=뢱5/#IVdWǵ|lLF1 &gMv=qc
GP- Y!K{maR/<@c殈_ݶixV[ZaCL|g#'!jSOfq%zM߉/K "Iv ^m&| !' V|綞ms<^nA)*c2r+ .o}{ۗG[/*UM^kSEdsԹ<d@R p xښH !T(^螋b
OAyP'5Ӏ zc9!̝0^p*2 #`0>
B9'1J 7m-o`l{ wzfsaVZI&L Vy t>N1VH#+hL# {VRqk& {8X7>Z#^
C9 26`g=oZ9! Wr?lCuTP$n8c* 7*آcf=ҩ H9]+LG`PC8銮}G k{ŻXQ+2 9s9үAPo38
j /'# Wu[B@ it:'˪[;
J~Qj92Ny`:VsRvv苏r]J'qa@!}˼uЕ$_ Q)'[=)4Ns[ťch ;O ^I/!Aco Z+WO3۔N l sYY D]]M 6Aryһ$rYMuКd0K *
#cbr0 3ۧҳVV6h Ms "
?tycQ-Ӵvp)`3 j˕3e+ m0Wek)VrtEJoQ]
߃ضq8
r^MQܚ 9<?S6E+It8р !<0p t= c8>ozn@})'7m M ;p Cx4" MpzsTh&7
Rr c*_-ќc
=F0 x@ |n[RBE ªvF? s?+6t}..kI+ @znԾ3.}?þPVsj:nZ=JOKQQ E$ yGYF,h`Zq^3rRMmf}&XbeRpd'
gY|3k|<.<3aӯܰ[ܱvy#dS)R5~ h_
i|:Pne"NrP* Fqyu#Q=)_s8ֱ#KHefx/ /Fi 7K|AHF NBgRC:('"o |ֵ h~!t|OfGn;X-'T$L>Ps>5&K--,S=oIX8G3}Mr8C ˡS#(t3-M @
7FԗʵL1ۥHqMjʕ59GCM6-5ۛyi ;\{=vkgoe9mAN)1`bqiZ4<<0nsFP17qV!d2Vѣ f68|ں #^n!4 >U p; *S^=D.Ғ;VhkZC x=KIdta̱}̭#nHө*q~&]yIPħ
Q8dkrZ:nP+i?L6mc.-ԖQjRB5wb[Tt_ jXsŤr2yJy V)B2t9J亾wq[^aR22"H!J &V_&
2Onv4Kh'|t]-kt&Դa$HQEyIOiVrmap HQ g eTӱ8 w;rz玕w@t4+*Ka|֪ꋶtܣi([Pzrbk $Aq sb3&owpsG6% kPK?iunK-uo6e{[m4Y-bV;91{w`y9Zx j CM:0<&R=}| 0u
~6ӳwiZݺ?fs/o xoC66yM"7N ڼJ5+l5HZC$,Ͱp X~Q߭tʭYGd:ťVvKq$2|Fu Mq
Y jpi^].O4bK%@ lp:Si| `NlmE~V*}HA+RծHɑTFw|sQR~2mihzP:%\I-
cj1kϾѦyzIbķL^x`K |x+M\-z1)J.TA3En"ȤZ5;plt}?Ohp9r,O `ױ*RQ;'ȩ
*o|[\x.I aXHE") ms{=~cd
4%^xzj.} Ѿ j Mf3fC x ֺ1&<0\\\Hv~7#b.s;$=r+ZWWs:&7vLX;Pdsץzv |\WKfC" |3+ 5*\ [ug~2#jGʼnxsK,vy=q ㈖9qӥxfk}/. \QTog,6{7W8k&T"ֻ^IPPKVۊnx&#-"JebG@:A̍'<`qkoȹEhSö +n *9 !MHc!m䅤p پ9aC <+JmjG;B3
yQaSG"5 BT)+ fB-׀ iе=c3$·y]a7H麽Bib}ժЅ6t=l;Xk"uH|7XC5\YMM n qG=+=ń4``t[{]d=xr]5߀N69m PIUu+ MĀ3|pNsw6sGΈ7; 9 MEF_\%L4!41Jϩ\Gus4ؐDn +Y:>!M=pBOt%ȉZ GOy L DiK 3U p2Ņ2>˘rq",[mT 8QNY
8zދN4(KITK 8٣fVsmUӯ"Dbʒ uo]V涓闶Sžng7q]\#l} Iz)ܶ]
/-x2ԶT
w[N&U!x1 dE|T# |m?Z~m[+ _.&pΫpy*o庖3e 8楁gBb
!I? l2J x+4=a<=kK h glĆVaoq_L3&
DŽ/7TLg`U<* h:Yn/`\TU
Zܺ܂W_5b5`cڽ&RjŤS+gjK>ԵKBԬ&9 :cJ.3߮Nwxn3Q^֦6kˡ2! 9:
{ܻ n ]9ަ6>k.Wb&@<:qUcw
13w[z㿡Q;v>m$%nz XV!pOJ*F*)М8 ~_oҳ+OһVHL nhiZKBap ?'L@
1/VBI-{ Q{) z
p^bv(` ϰ* q\V% ` sGcSv2ߧ
+
IN>] )=v#帨Oȸ|*脩
Ep
3`~E8là4
hzayߚ2: tPX.*XK
0`1o U?R
#( {>kЉ9_GxZfI+sT{-!U8 @`W;J
Av$S{ O T&>r[],KFSqHQ~bKV xJc8
n Y zbg 4ZPp94Ϳ0HޚjKl7i8 <_JRIuB^N;b+%t cGl{R'>d D pHw鴜 Rva꧞ U9;ZvГ 2 JH 1RգDVYC{g X{cn0 +Gi'b3Ԍ@<.{rx rJڒ#Ө1!'p ܽS&Ɠی`c ?%s^nhBF1^'
:
v'}asջJ>oz1E֚z
W t 㚶p} \.kdޭF Q,Jquu(FHD?} PE PE qNJ 7.? ##vJ gEH # ' / 3ޣ )88 t= > ~"'GA9L9|5w^+[b!> UrC /shn)%m[=QUhqșh
1 T }?ҋ[mR%A@ J $sh4;gUry=3ZFBW ;Tx08\II
88늌@pˌqW bN,B=zΙGe<uRg=D2'q {ڰH 7s>ҤՎY(,/짎U"W0E{UUYX\UfXr0Ϩ3JqR߁Awqt8)V g[P0IϖB r!U `wkЌZ8GCpL҆)-饆OaT.Gx'#G* cqF̗%ՆUHn3ߔ "FP`IqZ4~$es |Ӂ8`5]MTcx+ - vVNʥ Gː9?6@Kx0 d Z(hՈP"A .3P}FWx}MgߞInq]ww+wLgqpk#&6Qj'XĪ1OP@\!#
q>UwkcڅT uIʜtyZ;#k1HcqNV-K]:H?E JX\܈ i݈#m{t(mx IFp8 N2vVӰ'8=0~_9+؎?Jk
8 y % ]w#=1uLFT "QwZ6>Z> ZNִ=Nlm?h/DR[;Ѝݜ/J#7
,7Z-Ƒd׆Hdj {ם |bPA(82I_)sѾY)IZ2k/}w⇉1m}7LMӖ;}DHHUB_J◇IW.O 1[ިҗ Ggc>+b}nw]Cl K"Ic WȤZ [H|#]#U4:P9R_
C#[ 1Lbg1'lK&-`;
:F P]` }¾< (`dvTmOG NxI֊'m:;~'ζ ~ @xn\poڄ7" 1 WM g@?]+z,ATu+y%\u),$uoR
o9%sej+ITW⥆_SѼ0z^sIl!-)fLь'M~3 5- Z[]}:JQj=9mkk}v:n X<%&Ksok16 %a|ۘ⽢W w
M2Yl5
KJ;(3,--)//./
R0՚QRKH=//WVFa<\}?/IIt|V~ ƙ}}\hi 0MDZ:nҡE80reB!B2Wѽ6xZ֤GFCD $x}Im}C%ޫ%VS( 6'~{W5wܭ\[jr. -`tepp2kѩ:t>_wvP(#WG{+k 4w~3r2k< +SI4maYAw\E-q4PC, #֢Ӓ#0q^F_Q|m6iwZj; LK 29T 2ּW}RL~)u-KB& y5S v
>˲tѝpqWJVq!4_zHuk QLن;x*c]Ý3~u[9]
gN[.)6о^~(^)m;D%g/IQIֽy`*Z2iW(Ӟ' ZˣixvDuqr:6O aQ 7;c\ֱ̞N| ci ݬAtӅ<"01Ӛ2X6kG:Rqya-伮qןxv vZw؉0];l2ʑVb)
pFExexn;9ŝ$Ѻp[+ޥ^Nw+U`̭'ylLX̳_Kyyu>\$5IJcY$o 皹3ilehฝTg1r?Tn -!OܶGXΓk V[->)c ض([a$bq^ GOfcT|" mfc kB:d{ wAEVNW>{#Ŵ r k Y:jPi^y;e1ZTmF>G
8J}]_}<7|)]+Zm&ŶڧuM"+$mu-56_ɏa$'
QJrKTC)
w jCm
_QNVIIkbmjZXM "V `WQ Eyn-L?tl7/+j{Gbxw(JR\{quYZSY-!#Oֵt-
x![O+t!s1=s\5qTS9F'd8)Sm.ﵖ:m\ -Bxn.RFwrJmaeP G ~mzFjэJTorjNtѭ,m$2Mna $m!=N 5iټۏ97F , ҥ
+(Tu['b␙Sjm}g ^|+յj~/nևce4ovW[U$XژєJp> }aҒ9+IN^协y
L" sR-K4D|V*^9%vn0wKcҼ7Vk-G{y]{"~v*HNGȼ0zti2`1M"̮[ fxOޭi^!%z^0ټ=ioEF agSFխt,DECnZ E˖f%H,e㌱UdDj+J8-at»
ܮ6xR.$fք6CB=8"oI&@X{xXЦ烵_H)iH>Tee=rҗ,zrj=65HkVc+[]Ctm՚0 dt8omn'HhES%՜!̹< =Ut:RJ~:=EXiz5 nm-%6KR\)' F* ɨ0(j6,q' Flg'<[J|Y/4*s)Y.7}RH1-މl-n
H. t_Oѹxl~ybRšpW ܁VKA7-*yJrGqo: \dWW>:ұ~scJg{x xd +ӄқa:O˪gki"Ais U/nNbLe
%!kn \
]Bu//\N7v =}J>[K\ɨGtoo}/$ NÐ#W_i/lueŪaceuLWvJ^J^ 4aU7&~F#BY5^R *q/|g6 d ꖒicKIdھTLmt'v=rs]|66aS*8xl&mJu=mRٜmhf,T%azӭ{忇|meogg'FNuJë$A֯: ]5{%mrjFVJe---c] XHpK0݂^^ń:Fkhzj"B<
'y* oigm}zb%(TuǠsõ }THnaF_' 1cmc{çj3$( 5' ?F}wVH5x~iy젚4_) &5*T)|rW;?r\RסvZ5Śί$ҠeI`s5q(5fTKT,Q,FIGcSRR2Q5/ !uȝ^LΣqǥ:MB[M>U2 6{y`\uҧW{
&ԛmi ޏwt.I-47;YWm2BFI#"M:mh&\~Rq\Uj5QvCE(8(.8heY-/eY\ecWn3-NvWm!Wn 2GQ]?:tjZQWRL'*eoaKH) f vs ; Ƨh1lN =_W¬-xi쿿Oi=8bMܱ=z
XVhTs|-ѵh1jYe.[[Eʄa]EΒW}_-n7cwuumm,"Ӭl"Qup
p_8G. bxK:]Τ"12E$~
(Rv^V
Ru!4vMu߁ 5?_at
&2\@6-#vP0ш kG
NcnioDDⴲ)oʐpj2glc
qJ*݈\/ z G=33p1aEcN)hZN풹9qW#* Ʊc#h1b~(0*c9Rd&@*ʼ7|ҏ_EcHV cާ^ vm[a>U39 1@^9rGRI{ U3*p y OJI>(G8 u z UԿˑ5fQk}2ȣnoNQ{Uq{jK` oǞHz]`p T8N bT؞{C: Ւdhݽv8L(Po'j۱nZ%P1* 1%>l8mtmN ӱ|J H2.GQ4 ` fq8 P4 vG nп1!y:L b>UzʚG?4 Gl?yJi][a ֠-W
} h)rOJ,G-rF=Hc<ܡNZǨ,)<}3Lx:{u4"+t0ѐ y Gcn ϸZ+&QI 8 #> ` ԓڏ2 V`9tTx^8^>Si]O{lFȿ.gBT.i\`dAE2oH!$mH
q.H㚨hW.qz7FӥG E%%U66NQvӚ,@-1y$)3 1V&א0@WNG c;P]+ށ>PU-40G&
neHn3jEN#zZk``Ӱr{rqY MK88 Rظ[-QmxKpF}*c8>f&Hp>\ }c':x (At3pLfp3-黮}UK*5j+>r? F}
z ({vh7BMSx=3㱩Z&YnFOlF@'*¯9Q=+6[bK^:c8 <֦D+ __Zӡ`}9 .:m x )G PE PG s q@ 1<t7q(<`\)#9yh>IPM#!NyP$[w AH;юmVL9~QB so!/&`A±Q1ڠ0 7~+ӣxX-&9
7ީw(?ׁҽ5U;©{mdf1jp~^{VdJy"Ȟ;`xYv; luk 9=@ ?3 99#֨0\ q3٤ێ =>E[m38 1AIcc v=8Q! !A>D%0TTi!_\R&[ ?AO^@?XTxhʓFT~QTe}b^ *c z1 T0_i*%)/}% F?vTK( `6Mn:.|N~m [)
9(Ba̓FQ= .gn(J?< ]rE>}Ӧ4FPhc,O\
N>kчmN(:w-8r Mu>d@0N5ÊizxX˙;"R>R[Tcq_=V)FJǵJ:}| PvrpY>n3ר"t;B{h{_Q8*#lӷїk'm @ Ӂlfv 7M++G@3ݾ8 X<ыQw̿ <Ϡ~_m|oq< on}RO6s1) ;qM?n4o
e׆dkhlm:zn
FF:WgӣG :bx(JW((=z-4%ZVo|Tw
v"]Ii{2O:&me[ymJ 6[ C,<~Ƭmn3VҶ"Tҋ]\ ?vU=KDc r4 BRNkm(x S^ o{H"ůHõG* varXh jRuvUЂIK] [K#oe= lvv8[gQڼs&Ptw^ ot9
͜1;>)IhrN}IFI.Iy OWo x{ƣ
_DFt.X g̳H(*Y@ ' ,5߇^Lhi}7vz1WPSa(Ҍ y
' O]͠Qir_3bF-mƝC9]Zn !FtiJ@|`1 צ?ƾ":HZՌ:?tVVi3'̐_1l+B֚[2)U,KKROVkJ\\HFvh
|A7 ch 6 FT˅b9 v T$p`A^%uf5,]þ7>TC 3sӊҒWv~VRhqEb[ r #Xѝ*s۲ֵ;$e(VGPUOJH{q6i u?>0<7u%|1q_k 7v!)n;ݮ" 6rꚦj1r/q#_9-O5ﶀAlEoZJ\V)FL7գ~~GΙike%v";/s_m ZGJz~_Vu0u+9DSks걧Y]¬ʪb}Gx~ %5y4M;T*#;^s0v~vf)F,435# 0fT
|?Ȝȱ ֯SqJIY5# S96ݎG,f+u3E^JG Z]`A]# z[Z;-{9:NO6 +Ҭ"Y҅I}cpIkv8"gqIac-]JN|+?jw|n.lSH&yCHNFF燱wtRJ+Co ].Y4 kw4LXTqRMwy{=>ԝ *+]:4*iySR*Ɵ-ƛ<ײV\Cm# NOLbXA%:[\
>Y ]Ͷ6|ta1T_I7c9b˕3|<גx95#V^ go~k+Y#D\lnfڛ ur8?W,eH# b-= *gegb {:zrVkc%cm&T ߀?JxCӴHSi,ow[XD q͉tNm#xn&έ]6v @ӔBKAt8Xw$OsjBvϮ;Fqm.[TrrN߱/
=56ն7mˌtץuߊ?8-clc|0$|zgWSNv o$䢽iZϱЛACjW>cONwXҵ-Ymc-!%B7:e,_3D;D*IRN :K V;9w{GȤ)vM\f E)WvMR$i3[bXæK ,sV |,Ʃcx{-`6ecP
m< כe_JS%%1Rr(< y4-6 w~\k(S,PG~5,8HǏJ)Ir$Ҿ%FR5 o7lΝi5g%вt,\s7 -Qܪ"U
ogiRw][i;͎WX_Wdhqbޱ"IRsOo|";vFF<*'g-'Yk.Mms9Я
P+|v>-y Š\O=jM O<{4Z!o-nbۀ
F־- x;QMV%#V}LnU
7ukZG,/^yvꗝuFXjT %gKZ}YR&dS Nn;VDۉhʫ6zھΓZg6lM9YÚTmc쯽AA,W \dڲ8Ɣ席iI O^Xi"K/ncKKm *=j x~đ~M.tU+Ko -C D |u%mn.qU%5vںa.Jj"{f[ׯ.,lI_v H V-!mpL 'v\*PhV +C ٭vef %t l<
>TѼKeiuj&"%"ky 22@=
yp3UJ2Y8MC״->(+ڗLޓm$m,G6 px_Z
].l&kXᴵf94 r7Wj5j[:JTڵiu hVVחtv2nV =1^ k@ռ1Ɨ#ɧxg)$n|G.Y3JWN_%Nz 01JymŞO5H>C[+ 8 %GӬ|=y%-㡃JH!F <6+;z88h- edkaT䬝7m>v}w:ˮO^..M#y?wb75oewCIӷ蓴xVp/$p 3־Ώ09#U7Toǧ_NU7kM+Ƨ6֗MusRƲFC!s8ď*K֍uwsaꅤ<
r]<\vIלjF.]=lu ٣FDep *1 ՇcS\^rApO\
"]kJhFax3SW<9sGCEj KX
"Ʊd+#ak[nQLk ܗ !$F9&p4
qTv5VHkkD| ^_-8dMF[Jld,f2q^ j^?[ ]%6ф
]ƲDZ}q] kua%op|c t{2yibq);w^{UF M$\rYI4M <ۏnμ&.Wl\B vo8zzeX
NT %a;$ZWBx( 1\mB[q- *. {m~O [lim-10icZQwS1 n {?iQӴ8;io!XiA8% c眊 WRU- [wdxD
͏z*
q *Wi=.Jt\#'/Ko x{Q^\!in .H oHtCRW|t fǓ Ą5߂8z8:k4p9sE6s> KTW]9
.8BC+:vX3_IVx4C7匩K &&JN[q) s'in=_VPV\mv& g8 AYKFrhw i@9p9ϧjcKvqz7Ckv9 VWw
;i=rv` vjvHg죊jN
ﰡ!sJ C c}Mw ˢ`. , rc #4V+0)=y8~e wU)XcQ[d:N0) x 3iꗺU*\pst(JIho @qcp 5$8c}0@ Ͽ47ӱPK[-#A tՒ* NH8H dԭvVČ r Qчqۊk'@\68 zcpQ,,Ro_!+;nqB@!x80zdQz-;pp-C9ہ:{P$~0$A(8' ~ G͑nͫ+ 4)(cG?ʐ˟A@ <0 »23 * 8 i Ae 3Q=(ea|zSU Nh|];h0(Me;x=NFNZÊV};SvpL Z9ZZ،n8 >aOjVv[
G~G?/jfR*W2մCNLq:t?w8 ;gUiXjr5ݣ=A1)FrqBR:2~
1zG#w })Z]E(3`r8z
M `zg*Եa^l#'9m8\}*CsHvӞ.; Ӏ nOY^CRk(\sf צ$r@ @۟~:N`A& 92} )4hi
~^9=*u*
A 'aggqݢP)9 ÁmW 2r lUE;bS]QrpAqLp9aU[- xߝ&?'OoNHKmIv%)e 0;ʓеBHA 2u `ГىI=ڦŤ^Wr79S/C ޱI%V% zdӯNԣh?1=0$H *@G8?_j Z(
(&- (C7q ? .H PFRt6> yn.xZN8=A9ݞis zPI<>Q:@chNKl ix6،= 0Ӆo'B%1= yt|ʹR8Lӌ%o![}88997oI-ܮA<` }iz P҅^ 6}&]t"NNpzw2 qng+[ m<'1=ɭ4[tN=ק 88aq^snt`n :f'nF8EtF1n=J'1 `,8vE'{hh0**÷y!9 [®c8t-pj ՞87a < vVi =sg Ҥgk, hj [۳gc>U3d'q t9[vW33EJ+om, <{*#H`BJ(OCaϵ&J9*{7 }*hZr
#ݘ~5)>-yd'<=)X
N[@VGA< p3Ҟ
+N=WFk%T 0 Tˌ?tt@z) ^v$d# QϽ10m:cV+fGJZs.ѕ /N g:Ҋzt&mE˸89?Zԍ4Y 6 !u{hW{ø`>_ Qfg 0 PފqJ$B N?t9A85QJ)"ѫm3.p#]FtDxVpIÈu(5vc.~ lT)q}
&[/ 7B7|0iC6 `:RvQKCO@Rr u 08 \-08S??*6) ltiF:
!pWɧcL.szT ]pO t[\^[*O |纎ޔi;~`$SK +LmQ7]Dwײmd8"8 L_Zl7 е|I^jnU %B+.0]VVR:qx6.*Qª8i&F_RMgXB/Aqu5-C T5 go Z:_uȤ..ml#y5?r k t⼾ k4SEgkۨu)Uqť˥t箇?E} xUoou؞kuaaf &B8@د<9xI5[DѴ>or>- T7LG ٦w[ \J1ZY?/otJw}ޏBѮo<=&l5l"s(A2>UfG[g cmKnGyey7K?xxVaMFN-To՜Oi*-WbxE5վǩZRiDHQ]FYUɟ6f# ٯI85٬4K ۩26 3qi΅[ˣoՇKڧ[~-/ F eye3#jMiW%L3
W<+Kľ5*n<;ݤWMؑ*$tL"VNKv 4ܹ/fG^9{\\gutkpIwnd?X#{"[g3E'Ҝ ajS~ZTRKh6ҝVI 2DY>wJ3PүrS[ {P 0۽cR0Gmw[|ѫJ
RKI_>fw_Zo:=2J@_^Ht^%]fG4)u[w{F6k ejt/k+۲~'Yf.
^wemna2ghf[tb-ԎO^kړl#^nUA1un>͆*U-hGF .8´*3o8?~ijҋU)P[t$;Iqb=V晤c DHfCAku4높M귚PAͬnWs MyxP*弹O|P߄ Eto.,n .( Ǡ"R5_fX * m uul/:OYJ#.[%ʼnnu{3j-ydtO Oop̣
nkѦ}"cRc %!\1,y|'ͽP"
m4URmjc.y>]%,S](D6Jqr :W\<\ob9)'-Wm_J) O*Emm]ݐާ%rjO-i^ux"2@Q^UzIՋpsSWiɹ͜<G%ί|ƶ r6y8+-I.hY"H @`+BtӔc&S>ӻEVPnd0Lr;s]ƉVSJ` Dk#9?Zv'PZIkKCOE%}5ryq$,S?}8EK/DL$knEs/"d50yXVI(t{(Cq] {s";et# )#NqZ^=Ϋ4F֯l+{X}1]<*bJճz+7T.gyO⫫ F/maJmc(` 1۹ouΘѬbubb,1ǖ,<tn=XOi[Klr6~&эBKosspm`C6·'Vv:+
hoe2F#e\sth"ͭ[#ؤ" ̄O8l#ا5*4䗗<|ʛRK=HFu2ϫj)38($8m־?0[
ԛuQ`3n2k.~"IYJ5z82ִSOե#!vޛ57aܐ m56GHn5?y3[OU/cKeF\{<]/o'NNTP}֣fФq[(I7@Myƽ/åas=p̡ݸr;¿іPNkq䓌q?eҬmq{*Q=kӭ.uK-V`38FiIg 3 ӃSaeYfz OF[O{k(èK"k(~3<`CJS 7w,KvxpY\Dή -W+hD$klZ}2(fQmO KNiI'MCnR4Mc7+ sڽ7:$օ[I4.Hy-.T"mC ㊳isio|FkS3
_pS2I9F\t:?iZ܆Qx|Ă&l uo_JH$m%8Q"8gaTw58l=E~g*T֦ǂ7/|Whooio8#T _A|\m ٶ !Gy 8=+2G *\1~YkubRRI(맭ῌ~ oMmm Y%U# .#rI5_'Cmfv"="',\MK dQ`c5`Tn * ?>WvL ǹ>=5ʓ~D JcЃOWIl RvOCB78+'Jt2[ZE.
tI -XtӤҴDc PpFv;:Y˚J~A%d= NOԡEpdB] 9x$KnX ۿ|gּ,aܢy%uR\MhWƿmCttXl,B -FkGg[rXBN_428.XHC tjJVҕgQᯇ/ִۯ֭ hqed%"Y%=`2l v*g9iNҵ*
i;f֝MBxwy8L]j +u(>&*}(VW**2y!?E 0 ,r8= ¾;r $ aVsОzTM%4]Q2GsʲY-w
Hb8n@77`qQB[x
? #s'+HB%d9
@# *@0 8Q4 9 -FHc`V#A^8=5EgFx$JkFuЍTySXq=+vk2 5"LpZFan돭LމKuAL{ԉ!## R֗[,)4~A Jt.WOԂ0;u 8v WCn*?z=s S26O8GsM$5 J r9)p_CJV 1sӜ HO n J9|- nӥ4FGb?JmۡmH\q/ |\`ߊW^W^@8 n;$z)X`[$ Oj`hp?/ {m @]&j`#?xvk{.qBt;8p8${s@\dlR 74 hQ$vTgmӭ ty{’ <~4m DB
;{搨={!y :88Eh
я@3
Cg QDQ0[ww ZVWfhBP^ӷEv\ )E_ݐ20J==3 4& h=qiv ~TJعYYD!s6MI8c14]ě"Rz3`>#Fw@ cqMU\u(?-ah#
(aqGm6r>SОHz:1 ק|ѶhoIT˷8e{ 4H:cA=*+sG҇.EuԸ_R$`N9Tc%G5^_dF zep{d(9 VsVQ11i0vێyRZYV dGJR qG<}m Vm-?ÍNvjU d g]By,{ @oSWcpX1 r잨iع.9<s*y=rFFҧ.㓀1qs*^2qq cv3X< wS <ˁFG ۵- `s a9g>q=xzp9%Tu17~ wt ~i0 <3( Cg1 i2#i.{rTnh G^iO 4Aq?@ p1ӟOb6 0xe3 ?6~cӞs@{;xe L/ݎy9[Dx>dc / Vɻ[1 ~@{ )FG%y H!)$70{c_' ӲXq
1rcӋvٙ(Wrt:mjGV Ơ 0VZ
zXo aO q,@8?sUϭ?
9 2F8#i ̛Z+I;w8' Vdۑ|@ Iۡج߇5 zV%w :}
1?ۖNQ2QrqenL0p ^+UJ)dpʸf[,p8?
0k´z ;Ra OOgi FqH$J02t
Z}1' 9
?0>-.$ >\v)pC7`vi+;*劀8
9 E 嶟ϜTʍTZKh@,\u?Wn]r}<6F8ArG8?
p*It_-q9PF0£g2vR s(Mets#A\z K.ji(h (ۯU rITt˹KaChuΝ#g#9 41q#O7VBn`0 O=J>ZrzF.|v$M襉 ikc|*?zW-hf 3HZt7be H `t
ܵX1c ڔlzqUkpo@<c}ʬ U9ak9F W!Fsq
N=?yI$w%I _ǚX'mQߠdfVFqį^>2 ok%tN3G)@# 1~\rMGq=8iۊ8ϠRϿJRKA膜Kc|٧dc`vշWC_dqJp@OA J^C
$p0 zq֗ˎD1 }r26w.pw |cྥ|?֦fi м]=/z W^ak~NF+r 7J*Q Y&jJ> +)chxV% |C"|F4=:ˡ MC@( r?Z[>@V6u]3N-qrq -`kOUc} 8nqكp8,FZis&Yy}s֗v
ƢIX28S7zu͞ԮCEnH''HWLJ2e̤qֆ ڬ5Z|mmק̆+ jTX JH*ÿcQ5Ɗ[L[>+ O~+ty*sZ-iaQ%B*ig O o
z{eZ^\ۂP!44ö1F$%.)bhV;ԤH:ɦJ7}Dc"O>B4_XR=.v' 8\',SWm&v:z<9qjÛ 6yԣ[yYbp^kjǾ$5_
kZ!skBH/ %,b%Wm*s{{WvIwZmoTFSzrZI5x;o?]5BM&xE]$*%Ʀl=|W6J )?yGouoewF m&k(|(Uv3AnV&yj`R{[K&_҅LWI8EF Rױ֖mIv >B:x \e-%wĖ*Mܳ
0]K;v
W%+PaSzU}P-kCÖ mk~IgBw q^KP=/O@?Ep]t2RU ԩKyJr֭Ke\ fƮ3o$*z渫{>vI @y kL*BI[,DHњ|o܋[Y,.캝" m*I99:Kiv %O&Yv/"XtV~ZSR1#R2Ѯ D =;M $εgj5K#A;}y@ MJ4
MW@egwAj_N%ݵ7;h6qT5C{yt-o{W1hf'pf50n*3ÚiZUO}Ӌ>Gߟ
kσmèҶN^ONj..Gcj"7|Y >!5DYvޗqr.chdv 3~r:V .-Z7ʲ㩮lJBp =_U{kIzKH3]Tpr$jOSZ5)Svkvve+I[xSWc!' %˜Utk[K;.!ƚ% }1\Ua Cz8w* sE$֝dznz$vKhJ9XK4Jٶѱ$ 5`Sj=L94i
S10GZߴHUƉT[|{Rn#t ፻c%̑#1:[bծm"Qx\K#&Ԡ[7+6̕Se|I'Gq:!`n[ܕ=V8j7PUe Ia$r2k%G|= 9V{]Q^Ђ'5JOȣ bRdʑtU&̃!T%*V*KB~iQap`j!H!C,6 2zW< nVBy^-Ҳ$AY\u11#)d.plr)Ss|O{7%-ݽiggƈcn*Z31XKE$eukC)>Mvҧ+Kf榿 -@$ "p?+w 9l7+pUsǓ|4!8E{ >{F_;;iRK \^9W .ן llN uU0ux̗ >iJ1˥1JnTm G's6YY,lth~5geG\ z9G
G%9 M{aA ڟ4jl[5[kNIu}37({oXrP`f&c{ij]h\LCL@{PJp H>Ҕ¿ _Zv}{%#,!v"0[Dk*3man}4HSg_os Zkg{y-DjWn秵uV'/d ů&UH¼a*ke\&ӿ[|Z=~hnbCJYI nNҥGn/f;x[8rTgrQ#vջjZg->AsI4{[,cp8;U <לY
;D,N,FbFąۈ `ׅcկJvR`óyj^ڭZCdnA;i kFy\ܲO$LN?*,h5iR M{eJJ=v_o eiǢ ֱGms#- m ѹ#=3qY!i Xyze5B6&x cʖdSwەe'ҝ .Y7\|k/CѴ|")<$R|d9 9 sھd/[ĝqvU?neZJ\C3v
ISSZ.b/, "# rrO ZC,6/@S߯Z Oݱr5tIt+⺫\A X"I-ܑ d~s8^:=sqQ42 N8m/ %,ʉЀќc9 -LYɩJ
`IJ|I=kI){hkoTauFdiȖnsWrar_בc]8FЅ8U/g6v^VI."ޤ2ElĒN
YӼs
aۋ \O [}O$̒A q_MIKHmfs¤hz i~ hc;)40K"H*yoQ\t]CFL'&x^\Yv&&5nāZ8ԯJ#RN-*Ы)Ɵ,y.9:ɯk6v+ᨍ楠(0,W ꚞƑg{?~ƻ[\k:jK%e 1#
j;w0\vt<ߍg;8 {Y=K}Zk^[ : nNճm{}?v폇tvi IilJWl6 4UNT Vsg3C^SC]rm!9죵capE']*OUZFU< ڱ/WPacҢ|@Z O\㵼%\
RNdz*)~#ECtvcH8>ʨB0m 1tK.oo\jW[lot
կqh> m"OԮVѐHDr!v[ҦSVR簯ō7žԬ|yB;KkSs;FOP:Elx5(~⋓qpYZ[G6mm!*2I$y}Zu0[>. M B+0kjBԯm{h11` F `t .@vG֥Qr87tK@$P2+8V< ÎֳE,1Ae 8 WbwۥQCk8\n8( r9. Êjְvہq|r0 T-5ar2 PW
1b/weA.9dӥ3 11ɪQP)iТWNFz
cD$0 V_fg
p{f9[c
@vrq#[K
|=E] /Qm,iN=
4PN2rߔ)QQkXXrq{z҃ʃYٴku8=;STx"}=A3\`W=3ARV3 cs2(3÷ۂç P QcV+ޜ ۔>} &˽[ S` t^8mikzKrt9Nq1(
3 e~sIH
1OQOsǨIel 9(PyF(69M`9w\
6Bc ~9ۡ9Y3 ݣ `1߭?#NNQqSXZGE~mXd8R*q0`I5T ^{4е* S y g i4H1 玕RYmYYh\\ ^?={ p28Y eT+=;c@ ʜb.ob>rv=F_g AX6V[ gU$ /' f 7 iKQ)r::~T/J% 8aՂ Y9\[bu0qOo_WoRCOmrsT*qusjC9) 6OiIlr1 AlT :}< }GJv@Ҁpg ) 3ƀd/_á {u ^Fӧji[Mzᶞr MiОY[Np;c c'$Ukhe.k6!\cҀ\cSM.GϠOf 5 A vv$4,x cB:9Ò{
V+?.gLd:T[ -9mbД.2}2)Ў
a<8*28=i|§ޘ{%n{c8⟒#oJ-j6nU 1ԟϊv
nF:nJb
Gt vzT(U\qIrn7Ag.;@J{ %Gdhw2`q4g ~\T@9"K%gp\m#pNG_fmhq,-_]Yg{Tw.))7ej"ROn3:ޖy~Fekx#ZuMU<77 GK}s-~T`^$D
4n|7i|Q4 ź(t>"4In*bQ BNo2Pz9hj Mhz^i ;lجGL D'5 ]?x]!:*1i:v!օch1Qyy y/"l(Di;'qɮ o C{MWW Y֟n|6xFP+X
Ubjciƕ^j;ԧR9k;ӧC
Ǻ}ޤ/-um
'L$+iso#r6wo|S@Z ];N<4sq N5>o -
x?yMXyxَ.S^NOIWLkES}qi qsN( +NjK}m
TSEi%Q-խ"[U
a&l^7bU+9z1P'Gk8z6osiޑoߤ3M4V:y,U09 k>$xQ4:mPI})Hue \IpFsWl4jNm%G~-ѩ
I*iWѯ=Qr( g6kK==Kk[Yx0#2<^K5 o9Q\#RI _$ sx\Lp3JMۻyi%
57/ zkH*6ю#Iլ
ަmbSx;Ik]7l\vP4ry4s;DWhlE";Q],F#8MV]{~ѭUG)B(˹2yH fOUf%eF!
bpU攞.ZOm; 6 k{6KHZG=WVra-,2KZYc T RJr|QV^U }>6a}agj7V$7] 5Cn< sP)amfR^j:m fY"4+\pkpZ5-wohLz7SjKUzOP $0h6xu5 6ѩ
(5!_
/> xc[ tk_U
s5ΓVX#nGxvုK)oZWHg{HPb 6~i|?|c^JLo8#q4V/. )85k_gk꺯taiSMmAveU(
c}i;+m)xҨg(6sޱiCMc%v5[h$ =n|"⩵ic[8
,3DpY،Ú%ϬJ(s>t #|>,t rhvCj72{'V\Ke>觓ːH+üAN)c> no6I)XQ?^+xF&T}z U ZpmJmSm'Ue'QfwV{Iaha9 gOj ' Y PGc#QEye8bboqUU.ˎM2#I?$jARb8TpJ 6%)h g$FD.vw TI Ru||1>m0tO|<]?[osy$[_>HF=HREtu+bU'Q.s5[BR#쬴2ӷ冓a)S纉#0Cx{X\CEcVrHk+ƾ%nkmRZj}mI>Hq9k E7[
FRv7V5!B{ č?W<=A5
7]ֵ-~)']KXX#9# %V X$rVzm/ךRkY 7ez9T_1BKR"*|.Ugo7_>1i |u^_H> Ns$ yZ<znj<-|?=G,zbM &K0 lۆKJXI7JN__c2L,c_U5y}䣯oߴOx|=k`1"Mvgd_)PoH| ֹeo{wCn]}lL#V f k4僩<3bU:΄?gJ7qrǥrnDJ g@[ht
v;1
!WQ7QHV% v{JtTfin8
.7 owEQ@H i|2~"kbGmZo2ZYh=+zN!T
kj++O.;X rO^{SWPG"J" #9`דVN HKOUYc{;i/ynϨH1=0+(n$˼!˲矗8iVWZI567FkѴwcD
B91\ >m}qkgv.)Hd=
Wu[Xyao6'hʌ+)!*5Aݞ0H# vI*Q砭h\6ϫ;]A/ȅ`BUgX$z f_熮 _^
E_R[ R ppp+*Qo5aV{6/{FMCZ\XNf}9l)X~t>6zGf_Is #9-4H(>pXt58٥_ӆ''ꕟsZlLٕUJz+o3H u5m.qF so-k^$i$4eX2vϽc diM)>X\ܻcۡc?J⌿*G 9EE%kXɭR浼pYO-%OT# Y<*> ZV,c-wu(0RʝJ_v¥Irz]k)/a[gQ{ZiDd ! m ܊} m /Zԅ0YvW1 %Wrހ yB#*_W4"kmH#[r-C|qTI|(Y7(f)<F6gq-TTsZ|i좵fil)̮da# n$6Gidmnc0^Oq
K q]s]pRXhQKboG4.tya}Rs%#hrU ͦ#.2Zη
)6y*Rm.kB\S zh-rDW ˞qu*[}e'5,u 'yy% t=HBR7%gRZ\sƤY IcYYk ;# 7ݪԺj]=Z[%6s $P| 澇/Ҵue81u*.]txau>Tem{xei9 3Ocow.8l"5홃+Oj્30ثTZMe s ,eMrZ}-B x*L-+Ělp" "- 99G[tBAQ,wapc.,a [w >kIkDyQ$Z|mK$mQppt>ΕZpicX4_ciTdT#9BRL8ɷ{~F_uk6nlE ~DRZ0.Y=+5[VD--mq
ͺנYX1`uN*P՛TqPѯ+ dίZj $ie~d˃9Ϝ~)VF;,9= z8I(茪Fض3Uu|0קNi@%ȥ7f K-2^MJ{Bfذ# $tuHSסқ8;'sXYEbhf?(QqVvy:!}@/\n
W?cq>U>nX|T* w8g=mjbY.Z
7 sU69ic|l?5OGu+gӮtA}^+}qUw7l5
6I^C$(Tj..2 ВS$>~ѡ]`*ի*ʤ+d
ҧ *\隦SkC; J gz_F$$1{ԁ 8|n !w @}Yw PI%Բ
d~"یǖ*oe>^x bv S(PVM_a1NW7 OCɚWVV1*T xҩI=y[Xh S >]4WIYHXp@99) &0TZ}jLdSX1H!B ^X=,Q pnqj[]+){GM44 'hҜC H9A[ܮUgqG F ZvpI q
'fLfA*1 ƗqcQ} ) s N4qV^LH}eNrsTub bW I=x8I8cPw%)088zsڞ2$ `ߑ2d`# w9 cq;~O -Վ# Э편s=34'fcIy$+ mi
?kq.?;z{Sorv
8I h!mnғyPq1ޏOGa ?Sp>^ ҋep
8 s1( h)5"[YFL\2aqM(xԏf FɵA WАg>[$oFvʚ- _)Fr
21 p9HT}FOpE%'m
:g>Rpy'N3 #KO4wߡ"7 TqMZb30'{ZrkE9}*U1RO' l%'еr{/cxs*@dgֳ6%e< ;xGJ z v3R]PHJ=[ק˻SNp GJnzc
l9 F n的A'z~ vTd1w m`( 0byN\d^A#*6ׂ)= FA=qA銋iZcTgOw'ҎHpWWoO@
i *6?՜
Kuس7 ֝.#nJUչ\w8%Yi'k=M[7csFY[8%Jm:\Eӡ 6yy 5v2ݲI8s_1MͶϣRJ6EއN&ʨ=}Oyuczܓ ;\ $A `m,jw C L?fQpPO
pA{Сzmc 9IYj i$
*s8)_K w ;@T)9镣N^W"{OC~T`OڣU)h1,n `J'* \֧apڭĞ >YReU
̾QWGے͏zEAڗuk~?x ßWouû?k
omdImkȤeܻ{רJݧ|Ff5n4XXOF :p F5˟ dZkU.2̥(K/g➉i{/|48k:~-AtV
D^h#^>eGg# sOHhUz!Z/t;%%6
>$
q$jxж&)IFѻK (`rV3j2$+U-ץdϿu]JYs$]Rh^&,z!ڕbRI< o7)r!}?ZMz[Kb\3D* /2|)T_3}O%T\uKcឩxOn
r @k54'YguXn-L3(.~%ZKL ^"ҥBYhw"퍉_(z k0ձTN Њ§5h*?vh]vsեSGÞ mxEbע_.kct1bEp Z^KYWk]YgˆIɊ ymoŚOƼ7 *6mw_my4HeogtauzI> dvSZ6okZ5hch%Ns"G5:59NMZEcXgMʟ _lޱY: vz7m4m CG'HkwGՎ>Vv[ ӭ٘1Rsc-_d
[7gti
uhFU}vWS֢Mmy,>*,H>%k8* ~yh<=eS54ƃ;R^}+E?c{eÄYTJN}nqYөziYɝ0Uk|7^kWӡybάfz;(~B-+S[[٣D =tqF-zkS9ӓfk?Dz 8.fլI3#w 5^"ѭFR+5荼 &
ׯV5N1vO."J44:R[&:j:*ӫc˞h҄lݿ-5=ž'a@;H9e֢ 3$-qo h
bOowE60"Vs3nHѩdK pFS O["%]pˢѮ~h%xN톋hl4k?OާskOo Gx]70A\ƺ];k}7u1{a&MĎ[! }^)FQ'oMVx|)SqSZ^ks l4/v&$wӢ.mKsפ+Gn|WIun+tgP.
19?|UH?h#%k_ǟVI*x*ӛ ̿cJ[tYo՞Kr˥Q a$@>N1W
};@T~0Kܷ /nK'"H28&0фURD
oTmm25+
UC}T#9]Rj$]? TAXjooJy)-U}v;q~q pBM]uHL ӭj7vr4)'cZN
Q.5 =Nzf]71ڑW!y5PiZ?nÞdy߂-$N
@uV5! S SK>T6 o?XUu.~Oo%mYZ7ǜE$r>vK?x^$[eKahB^z? OR[
~̡4;+][y9>+Bo٧LT25air5]?|> ς 4 R[ *#c|$T 4HUSX+g[=O[|X\ xr u8b1m4ː 58N+Sv8E4- [?w_hT]$̯i8v?)!Al (<xWh-Ē7mE,2X0o߬>.GJ|U :^`yfYyN2q+Y1U/I[~1k%j7:Wwp/Wkz? K㗻4[/>+Mk[DI$fg\5~O~&OcDlqZE;ZiFt7P+h#cJ:kh sa~h;vm=WkB`T{dbAOCl}I#^+]pcjp~ݩlmm,+o9TOm~9j)7#K_K6&kXI wB仉8RK k-$1aHp
qC: Nګ΅Nkn] p V`ݰF0nkJQGUeq{8}=9#Nޯ5ŪnI6ٙ];nXe?t1`'}+5Qk#дɬ[5V-Coyʎ9z\Oi $xVxOfV §4e5 );|6n(%R5PWON{'y<T W45m!jU0
3 3R4['ҵkTHѴG[euU(LUUSyMl)yy$sqw}N ]3Fңs$ˆ`g;A;Zm/BNկWIQkwt qe0@]
ԍFWAYVsQ>G~hZ N2wʹ RV8;N7g\kn Om>+M3,r6 s3_*̱xu%MvV9g{iusvZ<i:Voq61/Fg$Mb|K|4v|aj1,h`Q0488'}[xy$F+] QGٺm ɭl'tQi ' (I2
>siJ}K+^}u])r
8+&G?/ot0|BẼ-MW6~eQ 5+NZS]uKQf~{~Mz]ZyI0f(c<\wlv>~5K KSVH"5 2Bϒ~?44NZOrIE8I-=[yɲ팅U=C ڮG bU̗bnS{:~g(ltKKV$YiVCe n$Ju[} K u |=<̱X]f\̉ʌlzj1IY%{UN:ғZz\淦2fm3rY4B= F5k-ndg*Aexg߇5Ρsg4~l`O5c1R6[e DRn\ 6z/ 5Yy01E0 nyT6Nr*ցxODM-o5k;.u)V/UrdL _-X̞+OUJRp/{f4ȵˋhm.=cY͵Rh|VTl0٭= Z搞 u3iqqk]PhpXߝQ}F [Q,E098t!Vۭ|Ш{FvZ\:ƉC
KwH VW-MnM;VYu;_ _Kpְʬpn Nխ :R9w-݅Q.yԽwNUWq1zd0v^*TV'B3ҹ}Aֲs<:E$; |OJW
(9mb*!BK~*4[
/LC=Mŭ929 pֹ+}@aFY̒Kk{Q q]UQ\{#Uzp hѿy|//|SZ5vޗu۩Ԟye 9m6r576k*NӼ/̳\F 8}\uFw]FQ泛+~6NLr̸$4aq61=m)1K/^)4iq9+$NFtm
EHio~oePOLpz[bno^ԕ:u*=n߁|Z35%QB[;r3]@UaD-vVV:)9%u~'<$ⵉ6큹烏j+n=ˠT N*QyH'JShwyia\2E9E1y6*>aӜyb.Ko- q4Qޘ;תx[&] m@hc\WFwѽ?S7mNu]gtuh
ejٷ'0@;eE-V
2~oyXԥ).֏*龺pVm)Y<ӯ]; e_կ-m0yj@Ht |;h:Pm)5r3
vlqtὧvz BP\j+ ]",P `TҪSi zێJ伅 T}sN^I}*¾'dųoH=R@tYIMEHYg-:{pKn:^x-mR}:S6 m4v<eXIvæJ8
~Mi2ˌ99;Ui Qt,# $sT@猞4/A ;QQL*VU j巘uUߕ7#CTeaOAUf p3v
c ,c=9jˏA 18Mw F1W5m=<[8 ǩNX0W4t r|1 im& p ٴǿڜs c znXwg @'#
KN `Qu'*:Nh&n =sMbAsJ1Q
Sӱ.RAB7+:
8s
м
眡ٌ8 sMJ w-9+jè q mD˃zvRq g5VSjEX S:й 3V]kÂx9#z9dcN+2֚ `'Vl ` zP3%rld/$ c#@3c؆i$0P@S{
jaAp=ʬF 0'͞kX%2p 0 .F{|/fՉdH
`gwsQ?u+jSr^d s W " }r zM
\ϐ)A?j;NqZū+T$$ |Fh=ozVlg sx<n=s P< $ #= ˎT: ! `ғp 8pz H sٱoʑH[1@ f 7 N >~ xrp})W?w\ aq,rTALo`cF8:9K Ў}5s=+$ r2 }}* ;Z)4& RH ƒN+۔:X}9b= nߺIgU sM$㧯LU`dv} oUW uJBܞ;v 9CorM mQa{^;rWvjG^z_A)/&rVW' ';\g(ے3G8bOlD4[*cp7d ?U ` Nrcӊ뵉r.X 5U yp=H&0ڴR3.-xd
IF=+=58_ebDUu_Ze<1۠Q^ jyU2crڣ.s t `}k}6fJr N*IЛK`^aBFH R7H LSw=@ d1,ӵ( {$(sʮ;vր2 Tgڡˢ
T1ܜTuǨ\4" Kch8FF1s=_^6;I9>vRo=sW\˔z22q8 1R( ꣵ)6V/IkИa_o,xzS73t ;u鰥 [=` J@ H' PAR=VIG S+<(mb+}0qd/ҕYzwbWԔI/^vg6G#7
r57 B2CnmDElxϽtP> 6N:p+1pqr> SY(r% m< fR
ּZU^* cf~ ˁX'ZNaq3 N뮃Ih°r 8Ma{~Ե}iFPc,H{
P8S0yQd*W#$ztSeo/wF6L1
;k6㨼.
QJVqj~_p*Q]K;gkk|)_Tdv?i]+g>cnU|
wa i; @%fdЭl|Iƺvl$ybp 7 95#ڤ:*>ӓG S jIUO{yo
O<֬0ZXG-qO'|T|14į hY34ĨŕxWf W<[{% Λ/oS#PpW?2qi&ߖNq㏅>2_e;_,`֙H5ԇkZBddGJ^ nC WēhVa}3ei]o1?6݁+֞#^&$&mdϖ\ x.j8k79/ό-/<~|/ii, Y&.V4{Ap$
-#h.+/xS,$+簲| hL&C8Ut6~)T #Լ#d#EB7+Fw#Zg\=M(Ps,]Oe$_ 1 BӴ \-5?ٴ&+xF*+2Չ5n# ?;^[60kzdžCgⶸ\L9S+b Ƅî.XyZQ쯫nPXY K #L a?_ > [KK-֑cJ=$*W`9'^[*jբͳ{$O'T>[Nwӳ&ӡ hBZ>k%c猥8CUn3~϶ %q?W ]Jr3߽B-|S,IV\yc k%N)ەJLBiFۢKfXfګ#t'{?/- =P
$ϘiF:
hˡuT.khZ"V:Yu-,E>IХUN-ƣZYڈw|qƗ+NFH8N zt-wul݊;P 9zXjqMNݭsO*T.[W-Q.n䴣tq"gE7]Эm14s ! N[_sGJ!&Frj1߯D[4$!HkeyDyOʸ`]'D/XB5Ӌ{59($ZӭGߕ=~, gڴMH峲\];DC2 *8$JR*!QFχ?m*<-~]*-K[R=?Ni "M!^yf [
kRL&2X̢H#Cp+AN1lh[N> 94H.Uċ }Q%2ĪzWCw^Q{Y/
4LCn ("
R$ڳlCk;? mgMyguIFIX;2D9'B 8UW٪{q$h=$ŀ
T#-qZSK}pJB4
kU{ڦh59Ǎm"ucF` '8^O Vq |6rxxBOkFz
vczr^]< 3z>a\s&o(PLqO#叩$
S@îZ _L^wsZChH,_F
[5MJ+ /kmy}4\y_r)si6,t ԛepA!brkд?u[y,4 g/حtc - V|um ljQ唡ho EW%A5ŋmcT1ltarqs|ꑩFD', R08>`I=u+qĬ\nf?YFixi WB[c9y5I訤 . U o3ͬ9gP${U3G!UXՉܤ
ہ'Ԟ%֕\/%ZNU#8ݟ$|Sjp (T
˞ގ]yvhݓ,,xn!2,e$Ā7ҴB魴OG~n.Ƙдq[ZFTG/N ~@[:P-@n8>T)qKbѓBG8w gk*u!,,XeyD 4fcIN3dkK[r N[KzH_/hu֯yى5__>\l(QI}/~K-FöLV<*ܫ TgEUJX^faN 5w%Rmik ܕ{/ڷH+-[c8QdU=[~&sjGZtj2
,ü%b#,LyWcU%Zu Qd:]7[ubJdl|$` ZP:
V~S|S ^F?'$38c'} $M7[Ju>
;Hau .mm; XBmoo븣R$x+ OIJoXhS(/; 1kS}:}Ni3o -tIU@sV2Q{[q^z[m, `˒8cͽW˙~?S.u(-xHKG
cB;Gy.eؗ; ճN+jKNWGqص OZW9!_# yGSg4'P7Qq7c.~ uoin"Ե F,4.{sF} ]?mZ6i- jWiI~ yw,-*
;~f%N=o_|GMwVttX.#ֵIwwȨg +-3,oTu NO
jzj#GTvGڴ^~[J{z|κS\l~Mfh$oF>l]3aFknJ1g_ANTSj9ji6nc^G(8dFzԃUVH˵7
I\ +\qvH ź Zwj: P#1xA " y!G>|rg?< :ѽ)h/.)xYg JHT[qFs鑞-o-5E R 8 LgSIZAX 7qAR?MÑ03Y%K1_,,yU?QRZ[\JHN_jyݞ6CvؚNH.7 q0}pcҲEG*2$-=moj4p\ =*&<=qS "S89ܟ
]uu^*LUk!~o*aq< ZF S9?C~n33ShkX |ۚM'nI;uo AL68 Mb|D9WNzZY Td zVҿbedTfm͍ )
8?u%m9@w O9
Clp;OSB; / `Tݯ#h[~6>Q$
W §3ٛ]c} 9oh#p `=8'VN+;+覐2!{ Th죥xE.G |#5W,/;~P,8& ]۾U 9zV m%c
*g: g&IAŲp
zf Χ;HE'#ʤWǨH# 1 #HR0p8i!ga8 ۇ=N:hPdH AT*1q ]d CA?63lRۯ+j=p8^)sGG
h9# (sצ^Z@ .<
n?(\qѧ
8 /!W 8 qt(w;KeqLӒ9??&BN` . (^x'(v $?+u u( g<~Uz`҂V1iR)NG| I'w >S= )Yt!Dx ~#Q2g H)2m0(^E#qֶwIjI[ t8)mlG$~ @ o*}A =N viiE1Ҭ*QcDX `r^7JTe\0
#]sN\cb9tb3;~?
Ǯ@QUl+ŭlLc å8|c3֓wwZc$=
@]GATܕĝ+6I',oF*_/EkM.ť :8$daT$4IYa%
7ҴceU B~^yz#M;1 vr? C݃$ܸsGz70 lJAN3wqA#< K` :wA8#t$ t@Ht:z]rEo!탌 ֣ /U I4 F1g@
`pJpF(-o!n;q(mیsޔ~# > !Ls34
7a J Ѱ[
P A:ilC[2)3=FzD?tqqҡa M&@G;@z@ rOi$\qM;@sգ;2Q;?J=դrJ:nFIbkRLl $ *ʀ9J+1 < ;LJ>g MEHR)Q J E88
OMی}@q|6 zgI5 Bq Ul\=p>I][[>B4dn8NOBlXQzsڕ: l' =zԨ.JNĀʎ*i>y4ѓA zԋW m56RV*rNr'O PÝH`^;F $v8 :(Jj5fR=ZGz{ Jﬕb{bC '&xNU>>P;.yU9}+G`@8I# =8QF8;ggNAw 9 qX J `rqZ 1T["1.pQIl \'gVd L=*pwtC(Md q^zP v221ʄ_O~S_'<; u;iW֍y#MRvvm_7eӧ<,%w}fէeJ>Zr4֟zmE|>mVNӼ[ |6ĵ]oxa$Hw9
]fm{+iZݮoChuy) M:6N p1l9\4x5p4dc!|g #_zM2~K%9rں?: zNT}>t[]6 ,.00G^]Vx\ %'RەuMhO))U e9I8k-5_fCº^zDvMwuNHsݥ\()ɭxM[iw2m/ I_1 +|ֹ,T1uaZvU:AJj^][YzOǢ=MwnϧVsڈh MaXl;/\?Q?O ;-dn% g?:4^
pSڿ V om~>
5^XxH[59 ? ɯ}#^< o <??5ޱubEx$ $jTnHWx 6a;'ts\]j)'Ҷuyex
_XC_TZO>[\.T eZ8Oc_vO} x%,#u-Z 9Q0hr\c)C >*[k4-EKG(v*$lñ1?}||A<7ڇ-k %MS1E,6Sو2m,w <ꔰ6N'7UO
Tp~WiXMWs[wdž~ 5?{ qsjQ &t^qv} sN
y ED2Z]mK>5ӼAi_NWKj'Tr7+*CD5K̟
xcZgYBů-|#[qkW[-,n!i6LcfPxvuD{Y٠[;Ivb< 4XR .Qq>\f21yZ~|>ß> hu7Ş*F> v wn5}v^&xeQExvX<`:5fm $o
7)NiZƱB]f#\=;+ /$e ϊ<
xk]
/B.M.8-5VTg1^L) 2+TNUߵvU#я|GwZIÚxVE%O|W77.mHB !qT{bIp*,32<]طD}k9ԋpQIGHԔя/6uuս-\O=}g?tq8ֺ[|?kk};}KʢQ&\r]24V|-GhyM>1^
4\
FF=k w_«sb<[~{l)2-eH "rW=lNu_ %%"=,G G+JJI=.RR➚jWQY
1aD9#&Mş}7J?蚅 .l[^A$\(
2Ϛ/oN6=oK:5u*|5NG KxjYtZ8t 56{Ai7mU8c]KCӴz=?LkM&> u:);)cGZqnubSq+V٫{;Em-֝lcb~ F@s$
<MÞ ^MaCq/D dg% yi)]Fj2ZZ^-]mwd1*ѷ c_T?'[+ k7STBҟL.3 ޜ%usxxM[-nٞ3>{@EV;'s9 h-Y\͖\"(s#1= Ugz{,U
Z=Puqizg..-[k8 #*9,
T -Mkdw5+g62mHDd36Teg뮯gJ\>!IQto=_XHoXAs!+s 13y ԼUa6. VW
M.
F7++nzcNQUMZROrYr_tLt 隦& [Pk ~ km&j0$+w`*a`<"V$+',~zy-/.jP^\rI6+w}p0=*uHmB8(XQp6 W{֔J6%F1Vz~E[x5C*@giLQBrv5{o_Oh*8-^B#6HynFC1?z .ekuФKe ܳ#ܼ) FSݴO]3ZF]izwhX@r(wz-rg6⢟S 5Jyӊ=-8{eka4[,Zi#X20* v忸x@>hԖJRJJހb~ǻz?3y . `i$l|&*ȯ7_ |9d֍/-RsfUyM*T`~[cw tSOQR:{ٵw$V 5ϖX%xrk~holZ'*
rW,NDی3j=+UӧH"bn&c; E%n,r 3z$1-dj^N]H#EQ9'p>V0u9qq՝MfjZN4
!!$O-Ά D"[\Jq"]S$n98__0ֶ;*pR.^Wmս mR)n,.-R\Ei4)'`qҲfm2 ʐz ڻ
Ts[^G|"_Gι,B #@ 5xJ5=fvs$P$s9- ڹk:wRѯϞqqJ<ѕn=OJ|oտ#Ʃ5ż c0˳i@r2x5<:ֺuzs ֎ 6:u'ʟ#Z 3n<>;qckSNDH5CY7S$\ N HxT '>&]5ZxZox
ӺMpV|ҦFьKkxKp:|vsi2e,nWk>8MN6 FFy4ſ`-. o'^ Zv,#fCM[{kai:w42hF]k|Q?'^)VJMNZ wFc[t9 H^1Xj3ظ8s|_y~-7@v&)IHBU5 i[MtFNn"VXdlׂ?Y[rNV`}Oև $|Q>M:_ &m ywzٝvG-ְ}_2ϥi ZRN[h@
1>29N GjY=-yGr#l3* 0rƤVd1L; ؤd vڤ%#f/w oľ(NfK @ʊ ŷ |(/u n;[{mxU@|F a b(ԧSܜe/[)44pN
&ys -nl7l{\0BQ؟j| 類\K631$5UDAiR8N7QvV/hPɃ 9 {Q LNO85*-kkï9@hPB ԈǕi~S?)RMmi~ۀϨ '=c s)XO#ta7 ZB #7}3
>\b0]Ix# xWB'986 QVBw穢_
'L = 1RE``)F_gBhO͵N2`bc
zdOqbP$x>RS@ +-9Q6VZlLӎ?*vA]qf?ΐc
2z SzH ##&HP@88P q߷ /JpS#$t쵺!=B)Vgdc @F 8Eaa^n*ԍBUɨvG#jFGp@Q h2!l$ uRL Zf /FO#P;azpOPH Zݾl
GU?{t ndЂBL$|>84g(f`9 j=qtFOTs;}r| qpҝ8
8^ 0_Y%-cF;Y8V4mqG?Oj(Z ]~_8ݐ psP?Bo+1h併w| ) ɭ+jAF@\v>4c\ 8gk^
1
h럛vx֦|l4PpHl ;g`O
VI')mF oNH ǿO֓]ޖ$8n6QZo9Xppm㏛=ǜt#'MQt\" P@@y ZpqML`1@8(i8~%B3pF i88RsԨhC7SAیMFͽܷmnĪ@e.PH8 z~VX~xhK
:ie@0/yM ;
kmQF ՝k P@v}t݀px|!6zE3n7l q?i뛫:&x>Vyekm-'rs", sZ9>G^7?/>hz~~+ f3Z̯ A4h?8\ge뫯[F nWϻֵe2ƶ!lW3WRnkݎmb{*ytgOiJ~(
bO \Co5@M3,ҽ&?PX=%՝~Z1G:tZVi+MƼMxr# Gq;ag l`zr+OnQcu-GV6OhQZ|V$K F ݍyJ9NH* nk{iИq41UV?^>|} ;>Ax^!i <ݩ1&g:¾''G*v-U:~kp 9UcC,Rj\(}5k}a,
ϝ%e{&}ɟ>鶚'_ ib+y8A@ QXxVҾskIld2]䤌K|݅s=WU$%o KRXjPMN:Z,xߊxv=uͦgah+mL.y ` Wú
Lj!3k55h/|0wm
17+ e|®5=%Ke|"RKN_q*i|A͇]/± ZpGn7c|C{m{]}GK4?U#KF##o0"$rxlGz[w7:26&p-='}sᇉo \G5ԣjR+2 $`+ [Ե RvKal%Q>w7dgʵl<>o5{}Ż8=Z{~& c'̜Aמ}7ĺo4[{vӭcY"G F*I"xZʬJ~*IJ B;y^ g5[]WYxs-WJſpFyxrh"?[V R\L;}b(mۑ3[a+fN#oyuT)QNԢ{y
-_ƣxcU_ \m~ A_c;q^/62ZIcNaK'kړ.Ԅ\L=^!Tøש%k8Wڤߩ}gueiu]ڏy'y(\kG\; " \k8It/ xRI}Mw$$,`l~=k 40'Z7//뱮/0JThw[-]ݷ?[|~o Z,t)i{E]6 &?s If # s.j=hIlׇHKIgf)HG15K
\q욶O/k8ԫ]~I5og
I|? 4/\kVQ\J
g.m QhtIgc Z|^X嵆$NܓG#P 偢xe^qUi'QǕoֆ)95(Zܲ'eq]Jͣ]k֑Oqq.,B$Ə'8 Ū%ac x v]x|%*)Ɣy}_S)u=6?O/.nbXolr`+cho"x3ᖑ}zBuI ȦO@n9NQog+t*N՝?n^$]kz]j4i/n!giIwm4υ^-Э.u8t =7Pс٭.t9X)!0b&9 9>gzt9h/ ( bݖQvѯgXx T !ku Ia)U*xv'ɼ?uhך|x,e7|s]j*҃VfʲM-FcKgĀ}Kn ԗW|&-ŷ9 }5(F3V Ԝh _"+V9%PC͕;O
8XS\ 1AebPvv+^
~ ֧io#,ev i퐆 Y!% {+MKh-nV&A"jDYNjTJ7MYxv Ni%,V{/Un6Ce9[EuKBAUӏ5KkĒZ^,!mwY #Ԯ-Ƙ,:ybv
M7mg ܩJ5FyS7? <s767Hy&Nhr_gwGNW؊tp,䥧,7_S⟀ |zVaϊtȥ+RdY# ȫ&0J}OЅLV[6AsmnS e?oxQ<_]_]֊Zriz`+B ~4E'u=TZY_hMcgCܻuc$m+Eg6r5f{ ]X(Վ#E=|ug>I I]j^Oԭ`o)alGJO$W~mR
jkAipZghdu#;כ7gh| :S$۽M{
--XH]P9uO iMoNn.xK=I#@H$c^M 68u- -cw2JH~xONN} kR r7^X8 ")h1|TcgmqЦiB4 - X(B-
u4顏Q Y
hh|u2 ¶pNJt!
5%2c(r}6kzk}'Hcm˓ItP8{X$Hx{iwtCnd
Nqg5eN_EnԫZ!̔V~ornnuo3O%Kй ?^MrWŭ/k W:ڝјZyT6aݎخ<%:Qz5Jtf[ OxƷe}Y#PhjIČʙ88^#NMѼX-gy<}/Y~;W*8іtQ9J5TjG_3 su%{c[s|gJ xCmiz&Oc+$gz10xZ.O0VtokMxu_y>+Kò5X;V7Hdf?7_
uaQA{?5\՚jN->e{_&^jc )82 m;~5k>"leo?Ӑ%crh0# Or8W5:4${8(}64' ub4vG
?Gw]j $ap5pRE3KȆ&Xf$W鸧8+'+#9Փַ鱩y]gfWr y+8H@_NsLt[O}3qj-n$Ng
>~Sޕ,leJrKu/qMMԍC5T䖺?\VnFBB<$z!ZCFKB[ CkIJYˌ}) ];T7-W iq4v_" P*l-I vUmJ9H (!{{ Jm[f[Z+ O#=o=X*z$WKa'ɗiʃ alYSi,,w ,V-+AӎT~->[r+>wMr^|Q}Nm%؋+n%Reٴ$uԭ?++M=*D{Vb?:,=KIs**K;uck*mw Si_i,ۅDpֶ5[F#;}$w],^G @tTg2\m#A(rrA `@@lhJIhRQ֞0O ]+ 1иKbY IJh>z ?6u:>m/)F nmZNkԵ-Zl`XIL `[L-ݵ֝Jt麼z}|)ӿ5/!5|Ok?A
Ϋ0 %ݷxu}ImK+hV/!9;SQZQeԽ)J,utyWY,rZ[\ !3AG#oZ CO4 ޫ\Gew6Zs]^<fP
@t=,g'( ͭ ? K"M/tFR
3n;s^g_H.-5!p7ڝv3š\x=eZZW}_e[j9}'4{}6 .uqy<7wVْآ*c- | \3pӭ|']?GjZvy{, sJNYT*@<5mJ}HNo; T|/ĕNu6:ާ] FZv.x0 qcX^Q-Ʃ.YH[*ښ";xBr̲g= ѣJ\u֩(^ӷ]n' /xwUo>_
i~D
'V{tװn
~c.4
o÷]OYVWFʙ?er29kG*tMCJymcRקi-"{
PCjgy 09A$qҼ_~"_M q]RK˵ pf*Pp+Qߺ}
-ߚ0G-nK@ 7++ I\y=Pn$tnk=
VإmqץlW]G*ǺH jTd7{wdCMFˡz/ackec#{8Fc-ޡ4E.)m'WY#$|G<+'*ݧo^QVhgß}BFЯ嶎N7U=Ą9'
|8Ĉ'e,fov\7}+%MVoXkf[}5aUxa
Hfz!^ԚSKRKc8KoC\-C/ie}FzRѪYXM{s{~m䁎8PB 6:ǩ
r=3V-b[9n㎃!*A|}kh=jY(U!pxyY
~]Q z'^EM~ÎiĞ@ʌ5M;w#8
x'
n098QgW{+%iAl❴x3+ț@sq֨mcGCǥ4˰V 6q"F$ * TЅފ. 41 <SQ)Wo~\goj,iԶ2co v ѳ@°=WFdW zT``> G jԟM&rqTv 8 c4' cmnnZ*| qڢ
wrr2HQڈks;\d>A .\8?7# dTxnU쮷CLq@Б! (7ՂjK1a0J_83ӯj
;t1\Hh=r)~ c Dimi=8 )R7g8j; Z/A`IIsٹKE2pܪ#
y9ߏʦK6 0bmU-(c\ғRO
q l*w/Nˏ\{R~Uh@%q~ ul|?.=)]8q 9z.irYx sTEvG Nj c
^
5# q1m-Q\b S LTfFFx ֱROK%b'xMDOO q-rKq0}z
zVllr<gTzO1ir;FN9j 0$` z+utDk'z8D۱pqV鵌 %A?t+ 6p9뢌$ٍIn@P cO95qyH3Ӊ
{v
ϡ:rbHՒc!
⻣m*'rj#qIV f=+
'~ǟQIhPle} ~ ۻ ^[<ӕLh}qMʀT B涚X-#
ԧ`uT1 )&WZ;X/f r)p#iJ!` F7rz'@9䴛.it
.>}wn})?( 4A.h% p /`-~rI
i+<`:gSJ3 <95M
B_T?pwrqJvw4t))Xpf m#J7aF~BG[sjmza'͐ x~cozțcdmq}qڭA1
s\VjrֈI\+|9,6 ֶ#\* W_4[eo * +t jM
UـWڼ)JriZ
Z4tZ|
(_nzcW.Q.
0#ҼIGͱع: DE Rvt13 }ӷ\nkKݶELruąq:va:dMԀ0y Nw}=*>) 9ϰ!c$~j2*&L zd`R rF^&#:4{
=:.8 m (@=+5xk_it dm;[oCjVm;d
|WNF^9˒/gφsCmE\XMn'4n~"-mc3\$L;$aȉ AUCV*_woaPO+ KWD3/W\dX4kU}Pg1Ial yv+U"Mi$kt[9on$#P6!9ҾJ\m<^x._5r/-gO X?;-2[skI#Fkg? xx#:Q=zׇ"=euZ E %G|#
-V
147k+-uIuv~!Pk:A1xEm&o-WQ LV@K" U?_ύ?gM+ u{+^-o^=Gk+9.2.'V;pT p
}+~¯c%{+hͭ![ ,*eG1Z&6~o^'2'|cm~ TX5'An+;'!$+==ݮ⛯69 %crຩex|]Y)>{XF2:ڭc۾x^\\|'+:V6 uەnbWhtk(J 467 mmR3Vv`I|Evn }ji$:1a!$c:5%쨴KTrLNseN>z^x~k.3خ|_S 1kk$ _
QFEŬf6O_I- caߕ]5>s!q\/ڛN\*8- o kzF>ůJ]2 ZH>[jQjP t֑)CylcO>)T[OSʼFWNzm[}v _xXl|Y
Y[Sԯzcʏp'|t< |i2G?$ܾXn#{Ezi2+zs<=&OğfmWQObÖrF99 ٿ.
^Py.o$be%'88r\҂n s/Oiji .fg &-K) !ϱ*3iQkmK\$qw;rP. 5SMLiT-hn3Pkgc|وB@5 X"dT 崣.>l}j X$}GRrr+#`@eU}`'}or=wpi $ =8\v.8:.
`/u~'GcS^! k< *?`]8 H`P@%>3_if{GkZ*<2tvD́rGg_h?>pf K>ݵsw [l]O]O h<%|~\aөY-r*#oJi-k~ ȫ+<QPsҾ#:s]Cwui8*pkԫVy%}g˖B\}c%[ h 7>i?io mD}˫i43[@`< _/njZF YUIf +˯ F] Z?gΆ5R֗ѧץ#Ioᗌe)g H ץ'"k$7ic l coWZd<:ޠ}̲mc2 ޯ@W^!z=χ>jZo'/-@3Lr7N2.fss)ΌU&ێ?9 _W{Ş, 4V~it^ Gj6ͥͩ]QR 뇕Ppwv'dVcDg8$#HM&s҉cgWE«wܾҽgij &tE?{jG m[ƶY VFG1?q VQ|bRJ+ 6e|cHVgƘ8#zi}^}?Rv+"Z9)A`z{b?ۣa7+{9>h^t MvC$,K}]q}4XYIx8pļ.AxZڭ:?%e#NY5_Ŷ
"uK80
+*>Y.HAhZ5-+c4F~PzWEF&-^7 .t_Oӧtev U;z+ gÖ{x*w<`̇dɫlr<:ѮٮCVK& oGzeO\dI<і劮P{{Bj:7]ݕyRTmp' =o<|Љ6np~Ul'J++Sf>M~
%#7L$^>!WU76mTĆ(lPN=3\Sr_NQȭ㒲 㑷v56jZ NJp"imrCpX2ckA˒c@,d(x m+1 nӿ[JRRu!:Kn{.=
]ܟTdW/"29CS
M^_Z%C,[u7%`z4̠
͵=k4}퍤iGbAa 362V! "$vPIԩu+[+IZE-ټΨI QNֽ.'o j]/mFACgro \ (zgSҴ,֚t:
s7e݅m
缀 5R#Bs[wQӖMSi:m/( N+3pvc*4)6] q<FvON 5[8AsƦ.V]("zܱ 2 ^zzEY iD0$PIs$4Qq0nބJY> SEɓ Wj M
ٻ, Pęm?ZRQ XWoxAyRr\,$M҉{'־3^ 'JD]5Y xi}TC39iZ %zr7XVN+hocӠM(K6L|C(c%O;{Io]^QqlA{oںo^@i\,KgҽW}GvK鰇
e d' sW'AZzJZsmc4
}.L /Hs!'Ƿ=2ϒ@k~.+ 26cmwº.6oc<l`Hڭs֜;|tmjR ̒ڤ$\ڍ#"5$w ?注hw QT3H0$MiN.\K\gԚ5cRД墑p]3MFW"&$:#ۑMem&]FEⲻ+a^*u=cIn\(NT*;{ϰ>
3/QjWKso?`
UZS( yw |u 0+xXذXw2:֘:JT*GwPm)w}, U+ Vx5NVឋpۑ#8 koS54Ԭoo$uyNv/ ףJ_fI'ob.Mݫ[^߉VU 7ݰcۊÍ[Ħ4.h!9spe#8ԊҥuJ4v(\WN_OuoV-tQRZk˔F
]'VՀRGQm$#UmON1\mVDWW#X5-ay #^ץFt1
6RvV_IGKu{X_2˩_X^YgEy{ ]Rr63 K[R%m Zpy1Pt^UJy{;I5WkЇ $"RyK%G#G# +0v?ҾiKI.繸vIYEE*(
¨sdc[B1K=4HC*
³?SWlti0!S#lT@y"RbWNJQ2^y{`նcjnAVP@? TI5M{Xgi /l
Еc`v9F"SrO֤ ޕk )ç^JsWC OYM8ݴiʘ
r{U13*O#3@BQR33Qz4n*F0xE8#G Uߕ+Ei+c0{
Au *I@o4
ÞG^zSF21*a/{M#;d^O 1#~rZ7 Y횑w\ 7 Kn˭އWa= jtܖ# I8<c JЫ-؏\
ù`!y 4]I.~PTrӧ^)V^?gj)Zb9b{ @c>JEu1\
sx1zqDZ*DDe1j>3|
0yz>Th
K1 c *Ȩ H' QKH= Mt?XZGg'gi.rf MYر=G
,m 9FN ـכIPL7Vw.ul]
Fk7ݹR'cȧS_k_G kۍSNރ i~iw|02 ;t}. ipI*ѨAʨk?
t? Wo{Gx| iYv#$@{:~'x>"Ծ4˪X~fY;`| 9Jvk#*|E:mϧٽݗS0ы)4mY ǁ./xS-,<Y;I .scFRTq#7
> ?G.%χ~vQйyL"e.q|2RDS˞3 T˫:nj} ls
|uyy⟊xGBZi^] B[Β<ܧ tQ b
W3|DtuLO; l0m
m8iyk|D];^ыӗs
9Y)={5f~zǃ<.uKiwM&`x(m~enWx \V^&˻2è@ױa6YA{l:5waU)y},v*S{8'|1 wIռaf-k חw]Okh+7r+h?F6wY] a pp9 q[Qb'a̩Y|-[
%9Y۹;źč*t;^2Yּ_ )!u_&Ȗʶwc|s_v0,Ҫ H_h85ǎa*Ò)5l;ԜI$ 驙 M':\s4SG M`
pNpkS>%t QZŅ' ƻtשYӧM5{2$;0q uIHafpMq*m ف jmutIϯeVzGECyɑq z[ C^~2~A'|CHc m2{Hy0wWW+x5l5%ջ V=.N8dJ |c^5ÿxz`'5[iMoP]w:XeR#>^kTt>ZugY4&h @Xc~98BRluUNw6;yWRl퐌
xwBiWV=*U0Tg&ΣQC"`ˍ#RMS4CN<8N2!UsU(8{94 薞OPTx!P4Ȇ 3=xOt]_ QuŬ3ʳ#W&_5'}l-4d5gz7V7WЋ-gMb8Q+dmQ16ĺFkn Y<; aVy1h +b;[-dibU݁v *g5>UtBTq` ;֫4(9#>NpkDTdC͜ sn6)$!v ʢҖ\JPW=ǽiZɦijAfuAHG+nd秐fȲ d"6odG
A nʮI )W%ӱj u[JKx-IA ^3pvu&5֑0J A' wvA*g8q;svKFq)Om5|.C "O"Ho)9 qޛqvR =SN!͋|9 GSm 0+OlM:\BwvI+ :%Kx9 k nu}a/4 MwKFb >F);.%ASxgosMsͼo{_~[%.f|'PP;WnT)' lI Q< UPUZW̓#_;rHK2 n]) M+ qK_Ȑv6
L,ǜ#;{֪
'qk IqH=E&6 = 1V#4aa/ҦNa;ݎ%rXG£ʌȹ@FǟƗL=UhV1$g6b0'1ʹ^<ǚ2rylXA
K7Cۏ Qua5̬ cw 澻i'm\8 Lg#J-ƅh]B3'`oS:|1Z)I DN2[ ~lЩPsZKD= LnclC aq^࿉_+o_kAc6 <;G)_.vg0@RqqùomnVwRK?ij<J?1ֹ˵Qi!n`qD=˹Uߡ#xk֣J%>K&'Ǵ ej:ީxpA:xS&ɆΣ}7k7 ? It" 2S.wG.HyӫYӔN'tN- Gx^獾!}MZ xKAhZ̏]\0eF 9j^mn1y_-HQ
-+Y\%_n)5n.uke; =|/+Z^ 7
2\Yj[Qo, \#{fB&%+r8_3@];ĚֳjR<3G e
ʰ WN7 '#iP%OI2)Ղ~k[SѾx_M 8kkQ[,t@{Q'$gQZxY]h> Yp4=$"I} cR q湪ʌj:M+ =Y*yŽ`ity -sP "_h~%{ wtmjAxiᤎ@\eArqxEr<\՚n 7fmIׇOMѓ%J;rNΦO B%JI>aifRאr 㞕mcqO_,.uqoYEcvEpw ahѕyFVw'|O?l4ۘ$nY-A|lpZL zsⶺk-_W52,q!;U<ǵNJNs'%OV|U- 8B KVNJi_TKsmT0 r8Z}[8PW{khI-i;Kx ᏙU3.bXu;#I8ǭu폆| ax٢ZG;ܫ"1YP ,7kw9'+$~77^=kZ麌Ր".ğAǯ g¿xSw i[=/%7. L T 8BU ' F"rM& )%=xO|+_xr=XB sz-VK|2 #s{B]6;Զo,R [!OϷ,,*BFݾN*J0c3q,p^{GI\ 衲B+nOP
&F;U=zR7Z|nQ^dU@Ǟ*]M5v1@7m8*g*i ިҼc{st#%`r~Wh\~5HJ ~U.: pO9>H߱" RFe(G]lp2q)6m ^)=|PIv98HT BI+Z+ VӞ?&?F8- o B qPB?0I%}v j\# ~ [Dׅ$'q0%x sXI+KÒFGN8⛌dm %&$@02yXqۥC5N D̃@i8{ Z-Ȍ۩<{Tc})-i5Tr8z *x E
&OWB*Dr@n6{wj*(.Ps'=3zn ta'ќpN(* [AArz/ˌfӌp N(kv P:֞T/ ir[];qŀ ֜YsqCӥ&sT`{SwHu"-Q9>b I<03SiGix`{ ;3ʥT4\n
r08=[PKTu>{ cڪ)QJĊ@
w
OӞ*yubܑd
w) "p
>ST88('x8jͻ41p=2[?J~П#9 й0 'j.֖VQ}N;SpPV9i^J2FA
v
ϴ]?t cM&áM2#Ҙ3Ts;֍.[b-n0G H ʠP8 Gy vݵ{IJ# SK# Mn Sp 6=868ޣ* -<2r sѷqjOD\U]qߥK/Sw9m #8yٚ#2g#F(ӪT,Znjs kd-S48?˞B`/^ 폥
"а aw S߭TbﰪCu,O v}Ƿ֩e<O^*D py|g4 ~J1|0Hǵ0#Cc(|ĂN?jO1<צ>ؖݬ(|܌e{yz\J@VV8QSÎByMG{
K wQ<~6*{pv oA p8SL>8T0 $`Jp~8l3C#RV߀5">6n*yl̴Ć@
LY6 8 $9-Vl ?S w}þx+ӡ3g
i{YtH HP
HG%}MYt 1ǧ FҎQZa6pF9 QJn<1Y 3GO\x[]p)1sVK*3p ֫1
@ I }x-c9>Ems HS/z+l+
̕0_bN+wzXƭEfiS}*>a펙]$\*Aڹ9n> xs>i鵏3?fV Nqs+!b{e 1]{6Ҿ/Ȥ)$w`}ڱcQ{9oJI"ۇqXsF v^?JMjֽ9Ü@T{ w^[IX*vM#I An~Z(mZ
^T1#SN
ʛE} w c Č^*l[A2j 8 wWWB3 r1J/ `V6"=mFF0q{RWԩ-i
e;s֔zvְ^J$1"qjIC*vәXr3 }jXAӂ mE3cB`ݎ GH<B@
x5cTXP%`aB#+Ozub\u
Q:ێ n)鷁 $g%qӵI01=Ƞ!~b~\ ߗ$`Ӛ,.gVflfHZms r6xͯ )jQh>)}ISc{f}MҭN5!FZI}NOoNSWVmKė7 O y%Ŧ[3Y/E [207a4FYbukMHmpQ T_-eysEIF劽<DžFzR'H4}z@В{MbM5X-Ea\Ii'O Y+S[m5..
JT)kbX*`N' k,>λ=/wƷ): wGE_'x\ߌ{O /U5-RO`|VB1\h ķzI&]v}uj+>zMR*u e9>j[]_uBx7NZQwN[U_y G|LacZD4? o']Ic7. \Ɉbq WxjPź_ :xq Iy јBxԨb袾_/2PsaJ^-7ӿy7o _g4MKi
豆H"҃"bdv gӄrDĐ`gvbdv ~; &pMw4*'WRJSzwZ\> > /m! >'Ҵ # 8YB$+ M:j]j3O(;+2^z~u*09 4 uY'NZ OWMVKH'ukG;fy% D uuPOG 4=
@:vb1H'cp3N&U֙f *"-BU+N*[-/M(NouǹDk$n/$a̒4t Z yOcQ-SҴ]B_.O f ~wabՅ9^/T6l6F5rZiVWq+u$) f$ WONO|_]Pk | cK<ץ`Z;~+MzVE2k`:mRoI-}oj]mZsiYK4(۸ s_Nxž Ch~ X w#q!smpW ?(om7څŅܻ绽 v2my͏Rç:Y. {U4nU^l%_(OV$k3c`+Ey[jTӿi߂:/ O[ y$,1+<* i ƣcZ5սwq bYl`g].^N$/BCxz)|W Kq?⽝eٓÛ>x
"wfE-HG p|;/x٩b!BmOȸGK,(5Zu%+>]ڄS[##Z|_}w>yYxkm\=r#$U= =iJ NڴT6 J2d%8~Y(T[ʌ^|MGH~p7 x k
M4umJD=S_IAf6U`@Rw_?b:Z* tzn%-|mI xZŤU1ûn~N}Mxv5ޕw%ad"r#RAߞVco'='pWMoCDڳiybATͱAd` 9 *wO<6v-
!2 yl
ѧFMrioj%(k] W_&5KmَmS:#K\\_]&3 88y5 'w5ͷmkU)%ěO#q]t)$5g˪䎢EIk^/Spx/?<1"KҴm_JP[\x;WPk> ̎Yz7<$ZnmhF7vYGUQ=t'"I NkҲM%9фy4պo[IṼ{B
9m{,\C%[%$(dcY ^!дh5Hϧ_k#CU `C+PKl,ԋW[eoTҍNKg&i^>jkKC-/ Fd4{vJ_;x(-jmk2.-8XCo.II,ɩXGJz] _yaܧ{wi;[Gh:=7~߈IwVppڃ4'|1+d>ZGSѵ]C\Ne[Qswoi"jG%!6Yz:TŮlV8 Dq wK_w_SV-Mx .iox9 Z~&#Y]#)#͌&'#
_xºo5 G9 ]淍K gN19rIWWRXN>_;k}
] )|^5 9thk}RxRye~ д. ˨gQӭ,^9M(IU$ SƓOkt~$]FJ$y֣7ڵ !
p8C ( ѧ;K{I%ԒĪJ" 2(=Mk*t࣫5rNNH p+ ak<6
W^Ԡh`Ceg r`
pR]N?T1'kڧn;$4M=kI&i0/<]Jze 1\sUgW:[[ Z~zLڧu !|4ڃ_k_4pZ 'F w#I/4>"ZE̱Y RE|Xv63
)^1իu
*/% e-Ktu\aFQ,[X4+->y#vڴSŴM Xf#'̷
tϚWgM,DQ}qګ}¹ހ( {>az9
}B+ܠ!Beo[ri# }8 Jۘ%
̊y$4&%YGΖbɝҤX.nm8Q&lmNx b jUfvKhHw
8zw$ !&ݒ4n]*G%@ Z|A %Ѝ4\ o Ĥ| VS@gݼЬ-eZ9VgqQ$;vL_ZTP˧ڙbfo& KTǓA>LyV#PG a 7&i*+WŊ((O/8˴nl{[s?=56fR۳A &^J`*'n ߛk
&v݄EHÇcPXd
[%mu̟bI)JdX܇>f9${ N݂ V!_E
:Kuh%!i2g^F9Hw 2R_ҒmFVZ=? ck[|ǃ4 /!x̹.xwEHY gB;)$qP|{w~~mRkrN&7$JUvvu$AҫFN̳sMOO y,_fT5n|Hkĵ(C}Oogo]]1&M 6#fPjkΠZuczq7oԤՋoh^/zp'cx,/u!aҙm8 ;^?koAee$ m-/h-)l t'*NOM Bt%M5|B ņh[iRu[-prZ]BDִhHeB[x [ѤE J; j2m K
k4bOC2A؋+`٨c 3ӟjӟzUb2\۫4\/"O\M%XBsՑ7vK7=I<DN{\xƆqj,iOkgo<4Z-z sMg{V$.V'_^ZmW(t->Ck9kHW#4NN2쯯ܐP:5jT]?= N+m䴇V612ahsܫ Zxv-~$]2?e£v^~s+kxl5" }f+(<_3@bSEx{mŨXx29=W[b}s<璠qb Y]>[jt*wٷ_k~>SZF}٪H2JGҼ_]'^մ L`-L8ۏ^0{צTJ$ ^gC zλpWW$kzi{u# g#ּmZM5V4UF-
?5eT,g"KbƏk֩
|>5|1`"pIH>+aIRpOLv%FoZrdN
vׯQjzFDmo o GfUNy} g 'B[hq) {*JƊYnHWG5mv` <{V2z3k/Rx֤V d۔7 >\ON208']X ) `|'/O#XXo :c ew $з: cL#bGBAQry\H0q {Q(쯰ѭG aiM{ P69Jx@s cWlb+`
Îk
O
s:W,B[Xi'=@>2 +kk g'Tq'?~_"ԅGay ʞpr1?LtB108lےxk9&cV[X}3ҬFnG$ѬU%
@rď֕]IH\ cRDD
S'vz l
"3^jpm- võ g ♓
9J`rGJxqu 4r -GT/@% )5K . сT@@OEPzj-u%\18==i37 ҒBp~ :r9pyӌyzKb@p0=) Wc T\$tcڥSwe@Tv|ҽk p:2 6FG>0}*vmB8<n9
2ݑzR ]$014pq G4UrXp#`A lT[GV鰘 ےJ1G]n^ |Ub
:wb $OQF֪Qȁ 0X?
&1JA։5`Iz1M!2U/@wPnzs9"Ǎ`#&N (x{/n~.*mrp$v9Y4oǵ?p#=A}J$c8 Ρ ` xM;mk֮"
Rq Y( ̻r7dGk !I~-iKq;ztm ZE F3Գff9Qp}ZGb8 G@5DvB`1FK\]\?{8jn0Ix*ݸlFg8* P˸m85^WQ( ru9)TjXo+ /$"N\<㏥sUo.[٢9$J;8?=iʦ9VR] I%i|0[~UzStg$Zx0_CFZ.dR\~+giRU4IX%k\<( x %hv;h rnHQQ:ݟ\u&dk.
t=! ucgOSR-.6wc9 uFNJiu[$|ܒ~Slә[ڹ)#UeF6@{z$9h=ިwWVMŧ=b80
n*珽ǥLԴZ!Skk< 9OJ0L?y;80ЧsslurG{5#D~L@>6cՍ-nԒʼnRp?1]}2& E=]ŦO |W)s%˱Лh(d,v]֗p zqmۄv{c3] =2CƼ+;v=5{^%pTt CҜT( `eO={}*F #i vVnV(Fvtwn0+q 0+':ǬWm T` MtRKd>aִi㹞h-H,\MNt3_a_
<5
s SQм6ڝ楣Gfk[k :Wb#:QW藗sХO^e>zh9} ]G5[LJ.4R5WgxŪ?݀Wa$+wi}Yx;M4zV$s_j6CGebP5HRF*b\Jtzgz}'x
o<-Zia5{p]>|2uK(4~x.
Էȏ& [d9!0Ezѩ՜.?C ]|TpJ<;I[OCğ>%|GcޛM NEUt~5yHI&xFaE{hIn{IO!lpŘ;^&&qtғnv+?sSMF4~ ^jV{4
yo rZVk66r,V+ epwQSM%*.K3\XnLny1bđd j+k,2^{=w 0pz֘8%Mٯ-:y_ԍ4Ѣ-[_5Vk$C4̡TC
L(@ Y̨$p|䕕P<)TtZ}пd~( ;^0.<ͩhfBͼĒ%\u
.5 e{^bFO̮#w\T;`ҚՔJ~[ѭ?ѯo'y+ŭ{hcмEyhh'Uu̥ ; BJÃIeh?|aXZ뫣8E nw^Su'FWʞ*WMF ^[uG] V/I _]eos 2BFvc ~ v^x@Ŀ &|> g@cCC1-ue}~\ ٮC_tUk'}#n_{>*. F14]z# ah>3]0Z.og wy[e5'||Nվ:ŪG nב^h|]NឩxwQZ湫xXѯ,4 nTDI=?] [&>?-;y? XkNW_:Nuekmϔ%bu*҃|n7 qmpZ~t`˽ua_9PElmn\K73[$?1Mu8:I;M|ԡ>,G\"@\yn7vǭ Q߬mm* c'$) _KVO\եjx So;x\Kɺ9qBpI'־t]'N3XŖ-LԊa~kḢ&/ :Kݤޗo#)үmzLjo(5Ԣ;,SFlnb[p:Wk^2iɕ < g E}X]MTsr˧i3H@x^}8ko xUރ Em}=юKg[hvᶫ H檼 ÙGEBq}жzGO ƫ/O^4VxJ\} u5 >:uSJk♯|%W8m/<#xº hw5>0P2ŗ-+Чi9Ssޗ^ 6.$wc?Sx爼N&MNەcٛt`cR7M7Sb Mq=/C7RH!BwHw O K
QAi;q* ڮ^OOޓ¿
OU?> cuh˩]u2mR ohfPS/
xgv 5K]O!!__i0dnɎ"|s
ar:V=E;)/fO;ᏁKjz z<7DꚿIDeVǽy,ƶk^IjZe,x&2HV$bH}Y1ͮeg⮰tTakYG%_?V!:wUxILC Zż"v /WW2 p~ E8J7MJ1Q}?ϳYΟm kæǦhIc[avڲJ+xP mtg|鑋I._PQIrif}ņ2N+Tԍڬߚ&'s~] muwkׅݮo^OG~V<"lpP%?m~C5+Ee{ RJ*r@,K?h]x\5|<ӕnW:/wM.z_l\F%[ʹ rw#60y=5;n wk.qk#U\M&>r.HubTɾ]N: /-y ڦUoΌPw 8U ;JE%Z >n#r9 x^Q)BKc\%8(^m n[umrjѭs~ukRܽdΛF+o'qb.kUiJҏO=t9zQ/=8+y L,aJޤ]"JJri\,r FKh"_Ý D]w- O7Mc =.$ n5ikbYn$ĥ$f F,B`rs,qD< ڮ:Oֶ1;*x?ʠ۷ Z{M)/xR&n5f'fqV]no蔗E 0S㊎W~R\gk)peDVI<lk}Ƨv嶁Sr@Yر 9UB:]tTf[nGyn & mljdt}c]y_@; Zv7yW,b"}9.-'
e!|z *,Uȣ(} ܠ'wؗNPP[C!i19 rb tW7 [ #M l"ŬJGT w^uJ4N~v4iZŽ M [G}6H
J89z[/~T"5'@/tX7̢ߓˮ8008*j;*kW9 YBTw>Qo 6bMZK1Ӥa;lI玸eʦr]< S]>~Yo^6O1{}:E3*ozl&]PsMh[^HcGΩmas_-W,,]Zӓw^ti;>u |<&kKk]>o5js嘮%x@ gڸ x xkv(浒aT* ۏqA#QNsYӍi:th]!NpWӵ:3/$/n|9_ϤZij 6
%T*
k hΖM6a\H&4Q>7URz}VƔ7%-ǎ-.5y*jzo܇HRȆU$ȄBk,3|duѼ5k:؆x^ K[<קZta=ir-$9N=O&xO/cQu x"fF# 2{֎hzO[=#%T0 E|J*T~ouhM;NQ촭*[Q`m#GXzxSK^9mAku2ũi:ù-4u+K+W{fŜPHB7 ( HzTakC]UFK[ T#IЮ>
H _|x|I.c>؛ɲ<3ZON mon->n?\F?=k,=JuQ7~ch7M${kJ4 kZ5OMk*y:Js4tڋ ߠ 3Qy`YݏUg9r}ꢔck Z*ħN;d~t9SoRZnŪHhR22 8 qV"۞c8+[ANMhH3 I ďoq{ :OĕCpO";(@Î=}22c7kbu8@1MJd $p=
fJRKerId wN;vP;qT4LMҤ iNRo fzn<}E! Ǩz9ZkӖR:c8;s Q'f9lFG *d 3mdW
K)X. 8֞ g'7kZ贱m$ /ˌ1֦?01a8FNI>^@7gu @\Y48_i_b r@N09o_d n&N{g ?qL|6@
8sJS)%.Ui83A돭52AֲmvԮpc$ z
dڸrN*l5(i i|PNXϙ+) tq ( P/7;v )\GMit8?/83HN i$tĜ 6{c?:RfE9T zucRKk\Xu9[-A6"g ۵VnuqRVHۮtS*HA 'SZNI9nc86p9M;˗SkՏzc|N:F70vKno }
<>0pR%J\[\gqH_P; t/}/v@ tO`g :Rz}dpFHSK ^3 кI$3;q{}AOT+t}'Ɨ c hoa)8+XC0!@VVW2rA<
77 D0j b%{aD@ XY[~-;64V&p L ğ}i0QgK9L%DZ ᱑n?4gƉ@ 5\8Za)]hS9 6f?>Z-yLق0;W1HV7`0\Mz8efq d:J1kXֻCJ aګ OluWDb&m9
sn @ }k.Vz_0kg˸l.1:tw# 1E^WKa`qOJU )7o{0dbB Fyx@Pu p3J3;\|:w!;lz'_ր0 qbPF-I41 Ҕg$#OZWՆ݂=}2)H W'' |}jvVkDI^#GόvzT;(߱\^w#q8 vǭOT$aO#+;;X5 = rSd)cjҷ(Y Xd=c\#{X$yTUtzs+ƫ;S%>nsڼ|GFqJ1ՍhT̃h^@*;5wwUHPnߊ?vڦzyݸܥtʀ
σq9lpqT>BjYM+ YfXy}g cָqpn-TmXR u#px~(' r2>\SYyWd]
ߥ0FGozn{`9u'S {w@ހe#sJs'1U
/ $m4 ;wS73@`Nا( »MY8*}WT~0Ak: Qqsy
/e# ^vz?|g_>)AM.q7
Pz|(4Jx g ףULui'( 01 +㜊g2(g+N)MI˥eUlQ1>CX9j|U慡6geE X!7 vk۴i Zյ|];x`>N|LHɮhGJ([wh_N\hF tQM>!f \OwG[мGy`xd2iFeC&~#f*mQտ'ӚPo.༉Q8BHkZ*.*ϧ]
Z3)k}v};?jھKum ð:o*!O
ܷ H\/ ~*x/$~5m[ K;8v1ɚ!Rdz$dzcVä }uO#Q#D/HwEVAYƬg.q]:I֭PӠ- EԑT.>=+;[;)jf^tQj",J0qpq9 0ƾ[5bpkJ[] Zue*֗M5C%383J9䶟Um I\Bb! aBc ~x;__":ޱ|>muJk>vE2[16E,
hCў6uZVɸ
F%sAKn}= Ot YGԼK.aH.7 FFkOO?|cWL2jO$e-##3I('uV~(NKw#S
Z[Z6Ym9(/ |mjvseM;c1= Go 41Ff@n@xQ+6nͣ躸Rn\en_,|9k<=bXM4Nn VWe;$eaдi
Ιdqi#&K6W G+4xzrr۳)bR(ʃ'ooNǸ~f;?3OQÏ隼NƖǽ 'P X+.[J LLj4
2Sٵܧ HIܠ_K:3%Umez7,ƍZ5) ++J2=- ;Npsߡ=x#ƚЯ,I-Ϋy#/ "s+3c>g:(ʫj;;jcWڝr[jQ1p0gaWx{BD{kՑJ2ƄyOaך x' Zzь я%t8{fX'EBA_Wsv$2/zp9>g([y a SQ[ c wU ʴtC=Xk魥w:ijoq>5~9W`Gӵ
It:Uh
#h|l|F?R9I+*֒v\j~-/c㲂Qw$crj d#ݟ8A5p[ko":%F ]:G#%y&IsJ-e_[{oď:֗Gv&0?V!J+գN=8Di+, [-|Ԝ^O? ~?MsH|-fѭ-5+k:"-՜o[:@ rk🂼 ~+/,iwu?u9xCmhǼ00qc^sRj۫g]>"u9e
i. ⾉9UieM,S#d!, ʤ:|S >+jFÓs#vS M<,hJ.+Ki}^#^e-dގNFŵƩK@&iݨ|;t_EtDF!v
ҽW}oY>HzMqvy]O#pLL8l&S(C6=<6;tƽ5ڮ#o_4σ69)ș[ᲸIះ>-LJ|@:tZt
\1Kl'ILISGr]sJ=6~ӡ:ЭWZ.^ve
`ULJ|1됼}>.
-J<kC K}+ľ6 ;:g:o}ydKnJmbR(sj[뮎ǝ N^n6d +|Vu[]<7&ROe2u|x;_Zr&k=6[S䶏ՕpD"?kciͫ:ڵ أ˩\HKI<9pc}8J<;|iWJn'o> gúou-cS._Xnd0ɿJo^.%eVZ(H
U(B0|k{u=:<]*NsUʺo<$fk䙤.̎iԒs6A,/O.Y"V6" ghT z ֔&TOioQx;@Ӵk3 jmL2H$!pk=M_ՒWӔmNiۭz^7z/ *{=2\YiPU8y =Wyu
B!+ q3g)8JhɴMM#8xEUgی ?dp,,;/|Sn*6ݡ-mElE#X nC],CfU {z=7FKp璼\u"dv|('z}j͢ZD.~%[t`yHui='/^w<'
\{ ?I6 }I]<9usIy?h[\; d .OrIW-YB5)BzaSok ״Yi1Aԭ$E&=errA zbK{ejm %ږ;\NqWR̩F*6 i>W:MNھ 7W7sGȒ_[L/Qn,!tIz^Y)/ͭZeHj&9ae|FK} qWw2NeR#?%sWT8IPbb9w\~Vw)n\¦R#|A*{UV@5`TmKI%k >.li@")q
<<&Bߎ|S/BTOsʮYb6u88'}j[x}cH
QI.0JA$(c2?!DK`Kck<ұ_- ! ;CXJRm
r|maR'z;W9owe^_iFt)tN Vú:[ Z40ܾJ FkYqGMR]V;Sյ`s2B>
|/e,Sv]{()-Uy0ͭ.ukŽqq@P?BȩsT>6x>'{ۓ1))ej(`b3i=R}o
SyxR?~$Z5Γ{ =glzx_S5wڬ=6ZIZž7CiOH ДXNb]|9ߤ_|1$^ [ֵ=_R6{cPIedT;C |k/ wZW- k-$?,ڍ`1Ϧkץm%)T*2[<+? o5{F/F7ndP9 kAf :M-+XBy^ UaQ)+1 gU! Ӡ-T1UPCp^(|BD]2H=#Q
f
֖Z"XKa2sqNp.<`/
+Nn ķ:~i ծnj('ۚ<]Vt-;z| s[<#Gb@`cv1keMū7k3\vQIxB cAG>+xwE<3؍
HګK(,x ?n idA
&*@r[溾SZ0Vio_VhwMYs>2x'R뿵Aia6j֚MMr)!r6Sp/4&ӯ/`H@<J(lUZU {oC`kՀYd$UOM9.2H%8c=tc$ڽ[{{\G*[(*B6q}ͣ+ xK׃5 &u{{9lPڀ ac0 ZXjR|ϣ ά'Yi}CտP&] gaj_f @'WG/s?:vsb .Y)>ڨ1eCӢluR-d|{?{2FúEfeܵF@bp:Ŭ % dME.ױJUqO___ ([ĵl|AOu4*kZ%/u8oWG>xN綺Z=<c%
y ZB'
+31䶶.as _[}y7||cԿ 8'=Z*Wt EIʜ]➏n({ 㟮8ăw l| Zb_(9`| TV
ӱSS~D-.o09Uݥxٗ'Ҍ? 8 Ff _MvG\E`:0AF(V4JR 4BAwB1xB l:[[[b0qW7RǧTZ_.r@PSQkHv#voLG42pFмNi*GLm i@ $گэ! *I=ߖoqI-t =* 'hq~v4J1A A=N{7I+m9yTzڙш6O+V4;Cx<A T!oVV(sʜAёϯQVb7Fows /K] I+L`p ABC 0?KEkJKC3ӯ v ԨFޘ Ƴkȫ+"F8 G>Ԋ nl[Au c<7'GKO@u#d\@A
FH ]7{!p#møqɒa
Ei[Sv5%\~ zcn9ʏdd *Um5 oJx^' \uCQwVvC O $ qF:S&Ml)s )($`? {R WBGyN9 ݸcֆ45 n
G
^@暊 /]a p?u:K'\VMZJ'b<
V { Ϋ{J萐@ UYb q'ުz+ DYK¸y]q{ ݙJ SUHͅ b8Vn̓j;cҴmc^+ge.TѺ2>~T,X@tJUϱZ4SJ_cP y]- 5M^HS`}ҿ( 3N
Tҭ+nʸ c)G˷<.>P=ZWiwqA NɎ sR w~k I.[. nzm|S`\ S]Zxf c$?*з;H, Rx?SڳeB~:饎^v үE+rA\ WVF֒Knd`$OzbmV\@^MjRsCX
qMjg^[\uc}eZEaKc ]:2Qj0ua{!2PTBz GN7sT}hB egc4Qa,GLsϭu*yQ哶ҶƚH9 ǂ0x` ;psZh83GAI /qHW]ƒ ('A=0(q<ր s)4/F(vv#$zRoM =HW)/vn v JxlstSi(Ŕ[~9<o_&{{\K:² KvB_ !/<'|Mx{~2|Kx)Y)Cܓq9aqY5\V2en4'+C<mBs+ǣNwovR^>0S7wv 쉪FK˃:G W"V\`~g[(,='
c e`Ӽ3xAoz5H &WM""@ԥj:w:+WNm MX ۉd,>+ٯ(,pS;oPi:+J7c 3L4ʗZN +k &Fa`
)bCV6I˫j B~tjpٿ"#B[携 -A|lֶ]}xK9iZT?1pŗ}& 3*m;u9rI:)kx])7 -ȉ&4yH A6\C]K[qYny%$lOOj,cXNZS+<$9GHۿQ YQSV Zȓ͏݀zG| -}&MY-%ōPG%SBJY%b)FfA43,|7o
Z5n?uˉcC5җ Xz($1w]A6h& [;I a.7 xv'bVB SU*\e%|m.&2hʑU;" Zh&51Ey6v} 2)<Z,/< ut^Z^Vvj x U_xKO֓o/ Qꓫ0 M ZA.o([ZüQ9]D-
tR\OṿZ50j+vGZWWNVV*8Hтzn4,/[XR$|p@q QGQ֮'ӗM[Hdt !B(S9IƹT-8t:)ԵMcvW7]D
@) B3Ӝ֎,w,+q; cN9⽙Sxx+Ɩs쏶^/ IЦ4A<8֭c)X%h~sm
F셯>{g~!5tXtRJO -g䓊 *TI+=:^SPJUvm^_}aX{o,Xf#!n}s_+T7/xbDetR(ld-#ywm8ݳ"sf?Wn'
otQ\kK;vKǟ5 Oxk( vReH-w`T`zWʾ/w?Ey}({TV"3nF?-^tkw_ܰUS24>MxhԿ5K"Q\ ɉlNCwF 5M~, B_**ܔ14V눒4P(9 dz/6]gCH"rϩ.7;HJfǽp*RwVi:VNܪ#/iמ,|[xmrÖ~X[Ɛ,N|ÚBԼ3h m`osH3 R<ԽX J3otn?̩izVVkxw s_m Ʒ3|AG/.H|+M/cI#V jJN3DɽR
sC { ̕^Tctχ
?~|YyeϫݏO Գ?/wqk`gOԼ7_9 /YW%I-!\ n+
^Jzŭ. 6{ fUN\ \Lv6V]o'aSǚaB W? +:ׁ>"I/wM6iG`(%[ Ns`
ueI&궱SQf0J)$i_Q>~κ k?Úk^YʢZ\X ' ה]{|$煵WY"K)cH[x|FE]XMT[=P< Wty{odk䤻ebc
Geυ:(G_jT'+s5̨*g1:TNIӱ8i}o~ j7S0|ۋ*䳖' v3}o T +AӱN}t~HY p3ci=+s<,chOEXT̩p䅔LJx`=nvVW ;
,"kg^@T6+Qo*
V&ʌv 7/a=hoehߓVc#ڤ 土J7>t/ > n=.]NLƦSl{v!S:jRZۜ%Z5"SQY|\k^;X"d̆4B e>^ٮW|7ıqswB\Fm,,2 xLe:߯Kٗ\=wQ _ip3$iW7@lo<^4RS 泮u[BECs ۞دQM%멬Jr5c
[pevّu0:zᏍ\Y-k%K議CZ OGJҿJI+p&y%gsȵnZ7w<@Ŝ\t'`mEw[S4⬒whTnRF*cxx C[ė@gq,jAr: aW7IPiHĻn ]H 'aMICȁإU8"u:kÖZd:Ln3 &F:(Ԓ+pH 4NrpiJ:'o~ k>xRD f
0 ,cӨl^/ëX,4^5
R¢_4$xa| jt>"5 Y{+-.z k :g$2,;F
`=H+ =6P[L7tnC8 ²UU @V,
D~Uɐ衸WN[5֠5G!w c,Iz>IDMwQ}u|c6i " B|f5iv t ^/v[G-}6/:F\yA1bkcOԮ^MXl^xKnm kYɻ$CYB^}5b+ XX,J$ ?z& \0ۛ^XS|W}$˭ִ!Sj vgr2x?M+Xu8S6ޅ;:y[J vPOiƕy}mQhFgms$gZ7s QtԈwz ώ~t+}D}:$ڿ%!gֺ[. vZ5 nH]d0U2:9,Ǩ =v[uj¥(4_[?kvƛAu-@`6% n-W>"ukIu˙(᷸G.ۀ9#'i̯q]~v|~_ ~P/fRpy \ ~ 3n/?|gh:wF=ز#um~rFG9<=ߦåZ.)l 3 O|1k.}Fr!ޛUsJK&.o5/緸Դ.vQ"g!@CȬ(bv:|=Gqus:K6oDҭ Mq#q |ܞ7/K9gټŕJM1^_{7MVj+t } m}"
>y;m"-I:VO U߈4Kx~1>e֭`Q1+4wP c W>]bc?kʛz]Tֹd|I.KrIc<%K (bdž\8z/~Ɲx֠,'RZ) +r@`JFkRKIh|%M$ZRd%Yr{Ǯjk:0M4$̑Y[r sq]9{ <ɭ qv'qXm#`> ҫE;]C7 >ˏ7ge''d 9ZqFzЁ{E5dm`qۚ&nO8Q-qř/'|9
ۖ5> V _9e/ ?*TD WT(zdRIz
k w$qZ5]X)[q\08 Z)Wc{ PRIWI h r~pNwg_qS݉Cnߔs`}5Ǧ=iD
8sI֫a+]鰾o͞It$v̘ڪ0@9=pV-]=]w;>^m8ڮH%lGa~':|ҵI^%C;4ݽG8 TᯡQWI䞜mKq8i&7_(op swg8I8}+?^cNÊz-ЀTuǿ ty{:TfA@۠xs >##=%i'Q' &1 p~\1*.gu$`^ߝF\ B1ߝh6b ?w?zz K Z+vz* æWqڲk5LrSxc oj;T iI6cԊ8 6qަ# R(b>< c#)Y48 `3 .Hc wD@s 8$ z%"2ǎ O˚{he.pZr8< WV;wfHa F!yQS8li|6 s~ #o q艗l=Gõ!~=)EB6`azf VvmZ8 JoRr}ERzgk#0881-Mhcca*31*;,W< 5q*-Ur4s(KOuH UR܇D4cF \l}iv&-FJѰsN=*z&TNkG8$nOoʞO w Uˡ
)5! |0cޙ C Ðu]ܧ/-r0qT26;tQ(Zg%ȬlJ
m: hZL 9o8+5y RN
immW^W8:v)u JM" #Ђ]MU=P puF- RޛD087:|`7%\p4=
QC d Fi?' 硯aW$3Nt^KyV@0#{Z!=;
JjVӝO8_ p#cOw@ gF@7 ӵNA\ OtZX ~?Z029#N ֔g ` Nq W}CN4dѧtUdf%99INIBɭ})SoRV+?Sº#_zJլZF%Gћ< z>,.;,Z=.cʈhIe\;7a_, 'Mb lZߧT%u)-w4=[@}O%2 -a{$H
:e8
xmKO>W'ǏZI0i5I_%.>LxmF}^M_: 2/ldӍMY ]sQ?W uoR-SE::r詼+kYkh>$4o+ZcZ8Zt[B(q_IUoyaRtjKI5 ;.}pHh$02:zWx;P^v+OK2ѓ>㦾5+Y .3T ۚ c?[eWkKk!'q.D{kߴ#M֭EF5 MJ?Ze8=}:*p q51*n+M^] 'Un_ݍzl5,}gX?3 k~*o/t}Phڦ5( [$).ClF_IjS-k kԨAZ=x'O.`49#c~iv=ƫtY[si`&T 9G VW g5GU\aye++ϯ3}ZH,VKJ#sc#ZR'_&Wú,hiJVKa1C6l<5:ƥD
Ճkfνl^>Ơu}A]KQύB K tQO -? H[NpĒ2[> ZZ2I.:RqdݬM
=Ee$ @Ġcw'+loћP|U C>O'>J<% Isf)%^O$d0rsߎI{+ O>< .jl1kkd- gR|f ע2\-˄i}jm3 Gmo<7 Yx#Gk|p j 8q!1^?~05(<_C> $VaT+
4q eج;.[]mc Ɩ8j)+z73 &Zob!sg[6lOFϰb8OZiYh)FW*kBĺbs\ dUayV LEk7IKY'ӽl?Ai 55>Ibm- -,m\uq$Gu9dK'8DR2L*s:Vi}n8nZ~k^ǫ6oU9B6s4_އ>ڬ(m /-;yn:[]>nl~x]BL V p ;Oα\tVm94g%mwM 5ke_ XEnk]G>F~ x~] ZSyQ^ O[-6pHG{~1iMbͩa{4T]VA}'sO Ki!5- |q|Gju!(T*K p9x\eJغ=:1)rhft aVV6ID3n# )$[Py<;k}>Y>ʱAih;H 0?sS/Q}=W<[8_R{_g{` #2Fgj?x~ !Ӣu?]k)7dA'8l/aE JuUmF%g
MY%b~:OxwCLuJZ֯-VRQbUq,h@ZAO c E%@
(C @ʬdpQ d0ʝ\[}ᎧE 5}JmÚ-y.TFbpj?~zfm ZNwj7b-ĖQL@"|Ma^X=<,UIMՆr+{kkhxUcZ
,lѿ%Q> d91)T[hYt
Ig F.n =]Ny[^gYC h#`Lt$~`9 \b峿CIғj+SAQR'ȴ;=.YɎ"35Ĭf}N9qoh^[oQk+NLȟfbH#lz¼Bmy
*Iʫ\ֶ WPwlf_ ͷi3X'P ~\ _y #$W^ ԟ%½lU VQ_OCOYximc]wR #O^ZD::l H ⿈_
c6m$/5ۍO6y-P[H,98էWR-7hˮO R8(/a)[kVFݟMn|iC&-pJb1T:^]L 8g:Ա㺋z34?\o5+ "K28u<0p8</,g%.[[5Xm&d_Cޘ0:T%zuO"*L=nGu|[_Wk}?A졖i4gXY _%jcĭrSz>BtUjУ KjCT kVvKHtO-nNv% 1;+(\?3yn+zpIUz]ZOW)ݝ!AM*t#)6Hf^v {iV:bN\y BwHǖn^#B7kinPIs!Rf qWJN_jVbRr78'! 1Ŵ BK<TM5k;Ԍ.ڇm,1Z x!|
HF :[ CČ߾kTgͶJ|MYG vu䌖VuΗnvJI(K 9at6g4,9 We46#Wy>iNy(c$I=kb{{+s>)VͽDYո죢C u9ڞ#9SQm74Np
÷W}ZWWbQhH#9^Tv{nRR彄$m<隵 H Q
ž*Zkm%W\hYvߧC5Ӆ}ƚO 1=4˘
t
&;kmo گ" 9 zѧggd%VtԊt0|Uk9%Hf(.Q uCb9ҠԼM>^XtVy8MSsm%KXb.#Vg9Q NԺ\wC 5C
ThCvvRZX얆lec K(]HarzLJ>/|Lo_oe4RM:lkcn e!s#PZIߙӪ #usu} W,kbY';k[ry .@?Ңo79IMƝg%u
#YI<6B[g3.T6H
}ׂ/6wO / ?ϪҼ\1UH*
svLg*=j).YG+>3=kLI<i4ZebTVCrT=*6t[# :5סfٯͺVt8Wb1tT "{v;q2PJ stnF*5YsWnt}rA<%Ƃy$D\D=qBj1T ۼOVefRf}@8mTd#,PI+ŋzfsk) $ :4y@dRoZDzEFG,L z YIiغXyjqm=A~#|=okz M N{ Kۋ73i{迅>G+^W^ԼAk^ ,Z=Ҵv퉄A `0҇+_cl=JxjPZ꺟?|El<q▱։qo qIK
A^xWÿa:fGmG ]I%nďF`
*x_c 5ܥcs u
SJlLk~dUJVG
( ( m8{ "GF'o{J9R}'^??g/_gR1-&mn5r;Kk ih[ gZo'²OZwQY!GDIL"b%s VV؈{I(Ԗ-.ZS3w[mW},SKa \:+ˉ ; z5%/]a >fNpnNhx[6K8-VfzTrZ[j~ѵ Vyq 7+Cǿ_xW \z ^i:tF;yflpӝN}mdPɩʛQ7ҵ[(Ŭ75.cw&#] 9R lK;MMҢuK+TD10- rwd~5a%Y>ըE}L Oc'h5lz>[Y&yL
M_6]fxذwk I
+u;Nu{i6`kKھڬ.j:U{!tUQdnw+igCaz)p8X`׃U{js}L#uW #ּ3N,g.E8Yq. 4Ga]ko`I4u( -߸ c]
h 뾷 q~#CW ڎZvQ¬̩k=͖;fSu/Mcoi{au羭n+[r)8$`ӭ{XZui҇#島3}b瞱i3>J!q=~칒R延[J f;H cfnJ/U}L(W#LH^ÏW*iZ\p9N898銤V4xPq d00;Shȱij 1wsz_Öt2Wh$2=
i(?N8iGpF
}E8!{Xw9 p*P6y#=߶rع8Zp w +9cx{ 18vT巐Jp:c.)ߙ_iP 'zJ`e$k&#dЇx@:4OE9 i&t LTG?(㏼¡9kaq゠ ۃ jɔuV֝1o[k8CLc byt$dOY-4$p1➊3O*bim \6r E ?|ہ߃>m ZPb1 ;T'< *843tD,G¨y}؝9?Ia .{ըed8t x .0퐠qZۗmdufq juUݹ/k1qzQcn .ZVJHI#$9ZiBP:fZNu OSMީhZ^C dX>~Jz*\Z
=
@뷦XN|~\` 9J̘%;8 1/@3H^=8mix"M푸N
7wu- =݆ `S'r ;B称8 ef;xm jUrFOSDF >:; BF1r٤Si+ 0FA30]6qQ>%w V (I[px5ZI0PF88:viGBq QJO +`z s2@ y5kM]|ɓҞ dje.TKi|GLzcoTT
d9XsJk$ >S%ty98*y48R[Rﾺ- 1= Rb/ tnl7g ֛҇visN308 {m.By2JENYWe'"
"v+859lpWvg%KQ]FI!rxHc?xތ{۞;eG0: .X|TL~#?(jזSrJ{18bv 1ۊ\brHvґO9%%m b`?
1=p0kDar{gy 'ZPg҄ .[1ۨG 3_\b$ޢ }rz}(> `d \j!+D <`p0H" \힕iY Ǣvs:Iq
銥d)>X8X'-躍D! PV]sk' cjeTA?Qm]-O8 g#=v^7J-=+̨FM;\rv]z] 2x
!+rǗTN&Ꮷɑ41O 9#V6q
Nϣ~@rGjnp3p jm+d;ٵ`V{ןJz2:u8FO^V
m4Hp
:a}=n*e+Hz 58E~ACנ!@$ |O? w;
9 /fG=('3 O^5[i`:1αJ̍ Ͽ ZGX\K}zDӼ=5y8m RYd8 Mu_4u ?k^"qiֱMi#R"a@sP j_GY<7Iw#P
G Wpe\E(F7 ɆF&s*zIOXGw q6yoV,K2m?'zܧ_ l##,Qjvj-ua6og+ )9 qYf66xNp9+>];#2x9=۳5LDžnƫnu]CQ[E~m$[[klDB yF}R$7(Ҽk}ivܡ#獶ڸg5{ 31;FJc4֑Akܶqq #4j3 RȑFP*ᨾ5x= ĺZ+nO;o+fQq1I)#p6x^偌JJ씯bZ4B+(֚#~,1t߇Qi GC`kx+;IUiUO(+> igt7M4:sF $s+߭Nmrڰ-֜➟fMfpR85Kk+]oV:ŮVַ:Iig_gM?ԉ&̎)+G5x+>Es%yeb%սo"^0\%$mXLM|Y*ӻqaG #m7:*PѢ$$EFvþT wڎ* u_[ Z.wFw(@@^M{8Hc:UYʞ*Xz#U~+KhicwT5(5}GǸy|I2l#'k>(7G eU:lx k7DFy#݀50ӆ \{9*fGөvvyN-_/ی=h_W8/[μ(J6W8h}F{k4U~HU%$v'rz hi'ږ̶Dg`F2rsk8Ni W5
Ut#گ~R> 𥗈 W^ n#hKxeeTE-憏ې
e t6Q櫢$l& on [@mk
Q[ FEc'p8''}׳{ǣ7(VQu{jZѼ_|" [6XKE3yrJ [2`gG2a"r[ax)N_߂zG<1.D<7Y|J. ZG0 U$ iAoF 5yn4]>w;g3xBpBdf3:={ӵqjUASW߫;o Mo Zeť։ukvәo0 j$Ʋlg#k}XHuXn#0ŝd~HUFp;V =W'?sF8ʤkJ$FNvG+U (RpպfO,2F9J_JpgU봝[-chJQ '[I5ӨpMw@q^_O%/X:]\څK!ČϖVTJ?/a:ij͵|OxW6m̩/,/YG bēuZ Of&y^NЌ ex>VYŤ}J:jQZJRE >%7oGk5dlƗs@~x 4% M>ف+ʕ:T:Z?3^3qIḣGb T!:psV; fyh*['ӭ{5">xD;06RHʞkj]ZC,xXޱCTn\U^]pN۞)Zt4Fp0I H.55/v+Y?uQӋuaNqT8W@:xM}sw
H>< !$ 'ѣǧiiwl>uѼɶ&N:S5M \d_Po
ޘZE&H }pEt<ೱ a V[ SS jѥ֣9(*tՑ;Kh& aڧ8#̳Cק8Z\yߗ~EI30F JtҳF$2rh{$h%KRYq ݴqᔕX
VOIs 4[ o=\";\ZQj"JR@]sYS·X]$g ri<G ;S%eE)dRi/f@$?\FqҢEYXmCW$J,vU;mʦھƈwU41<@av xZ[oom|ne7*3 0=c*wVH6k8!22WԨ=~bB0,vtϵc')r5ġ%DJK
e>i
.5 Z[Bp>eE`D*N~鬯[MS^l ,eK伻v+ H ;WϙXr'J_qCN[)2 +< {c"Z
fi#
.×qקVu=vReS^+w
gml<-zq\ʪZ >;iu[GN咲ݪHY^ +4`5RcΕoz/t:LB̞d^\y#]3+<]IQ)Sk6j6I]zk^fmT6'.k{$HKEMwb\[o|0_NFr\5 !2c3ҕzIѩ h[>|-eӼ ^k"TƃnarVD*Vucue&jFZ Ēj.,VuT 5y2Q#l]uQN,,%A<=O7+u]/ɖKi"ܡF
UT| 7P[ _R J EkWinU{?,#^J~jjJTU *ՍKÖv[U~*=*IܽwbKs"O 5CZմq:%r\[5cxNF, \>W?zrp饯vv~xr}9bRK
m Rn;܆Q
}C^4_<_i?
m?iѠG cwQ ^i *ٵv Fmobе)tA $4hJ+zMylh`Ks4X#}.
3wu\=nhQOd'
78|/[j`5fX gVUȑrs
j >%#^ޖ<;Et!#xQ})aߨ>Kﮝ$d 0 ҡ/@pF?mfoRZYɣWU> jh>Oi[DeW MxzѴ\ ̯5֡ gKt'5JUo 9qlcxHMΉq%.6N:mp0=q]Fx<9 }BK\x%]Gk`a K'ԚN?#ܴW)qis* D'I v6^*Q$5mI,痧eiDj'(ПM|_6e~tp`x 2A=𧂦ohvqyqpXX[ Xj i[)CT寡?#ve_\El vH|!a<]8yj=Nsi d1rG;- 8oWy)%h'Kc k:*KcK{ؼJἨ+Dӑ8moSõ&+;qt҄'/ݮ_P,tvbTO{$ i>Ӟ kx~ Dey^,յHg :ba[
]QrEF Wԛ5%dx|Lxa$}ZӭndHH̠D e^[ۃ]R, I;kzNw>ÞjրihJ@qN0(gH$.8? E=r 1 9QL{I'Ob=Ó_Q=8^}_k" d ڛ3g xket #Bm''+Ib lD-#N:'hl1Q ^W{~C7;M`kovba`ۨgː1B,Rw?ɷo|O~4 w 1VD[
ݜ I "0 zj}gBt|)C{Ԋ;@ YYZȲO^1J 8`O ءk%dO M$~ORG|qXUwZlPp6 ?ZvF;sd+ي;қd `/=p1I=^)5k (2N91B6t1FVMXr;Q3|rx XXRЪ ~^RIx`2ag=5VfyT+y2ҺU7 mT`ӖF8 Ж/@p H$. s*$+ZȻ1Ɯ9Ngf
qWCD;w"2yk8\r{UilV\$:dUg4C"b0_ q~U!P|nEz_cΜJ+ЂCБ a1 R0k~]kuqfcҔ0@+ы(hQWl8l{
~~-3ڲ#$F ;ja@aa{\=_-7; Fpq?JIY7Mh) qc85a#v%UX'߃XԚm\)s<:/Aim"6 JÐe^q)qRjԨQ嚼Nİ`BɂqP `Cu:XcI{z(\ Xx%jcGT^¹]SOX.vGLc檥7WѩN>;gUm xȯDM,l[aPF3DfXjThC_} rO hz\2**v6ϧEǪYjp6.q^n>Rrz1Ef>"ZY-yyRNǽBnvRq85yQ)Y[ (Ξ%玠t
TK{Z-N PX qsV3#& xFzRi]b8ۏ0C(*~X뜏jJ&W uqݳ ev?as鏺^A ~%]zTA\X{Y4yn, jEtш̼
sbp tc
B+R+L I- k&K#ji_=+?~ .5Ohv.Jf ;#T.qTSXҾM%u=~>0W 4kA쮜^ھU5t={="
;¾$_LJ3tӭz?Sյ_ ז{_#(5Y|Gym vS,+欜֩r{*mgK NEL;o]5HJv9מ+[#GWZ%w 32y c5gY>)oY\Hvi1瓎T Ƹ1v؛I٧˺W,iKZ`k6R70Aqqu21L%s4
hWWvu 0Ii%[a+PiNR~FRO^Zx8/ AO+b[v|}|$ė\iY ֮<=?xM[S6Ww_[*6r~`b77ڭ^Z(n'' f*0'+lv& SԜinӅiK^_CԾ}
爵;V4/LlX sp ko5cXDm9?7k*\PQ]:K'3Ifԡ.nF( =*=q gZQNz#.gƣQoO_O·;ȁ_*q*t㿰]cPX3)LoA aO*Ԩ*R'h}vZyo|k1̄2w3G=4?Gx:H*0[0"Ln
'S^+_i5cCxUKWq2jSM#iYچkݶ)Q1f< le R'*5)F2[ؓAItgVkK]
%gWHSOaispGVqsq>+uYxPSeI, <)فTTziXNR(^fx^#YhiSnUC#TO)dpw J g qӵ[=&fR9TV+إKmvmX#crsҴv4 ?Y[Ou
Hn ԕ-5P\J;+'u8L3?g4 qđxfk"B E-Z6G}Ą5\e rT8ƌ_6u ;-Zį &diZf>^k(clޗvz WGU}bWSl;Kw#ּ_4V5Zinb+ԩ>xi~3>IҾ kͦaK;K[y= i8o»-ĺ 74X/.{+`Zcl )_NN-ҖcOKG8Iigj<4[4V)ZI5i1@LTX-OҼm䴒hy3 ^1B X*fSϯ8ҹQ5m*=[%dF9o(tUz-mY%w uk%Ǜ$!d1,r}k[M.G7l:ZGI ww{7{W#W ֝xM%&jvt
#f'#ǭy/c[Fh^A=0qjܥ8Z_i.;-/u[1\2\L_kٵ@1Ip?GJ\ ֺ :pK~"Gcc떺%6|Ow,%Ml@ Ykq -жF.u
y JPmn!8JRdдRj|"mP#nq]3Vm,ekOnev=~e 3\Ԫ)M>T9TV: gN_
ea2yluo1>袼[ϳQmG=k *
{۩MFn:ZVR.wdp:ONMuۉn &s0W_=lќ[9$Ĭ|GoZ6@Gq ʣ, RNOH~lwᏉ|EOO
Zsc4*$LY\<$tWq ^$8<"ʍFnֵb)d)IUF ' O ֺs=|q ʍ 7z+,m̑8eCkSҞcv?#qW'*=އ pz rǜ ' 1[{` ODE+ୢ4#\eG|UUL\i+#x)'4QFWEh"` w 娕 QJz6Gl ی},Xǧ5Zin*: =8r1؎6㚈HR-# h 412 c x
x?:vӱIkؑ* Aν c JdD uX.2pO<~C = ~m9+N5'~\Z
rp`
g dwjVE8#$ 8zoFOpv~J k 08 q5S%G*yWudGV.dc)W pzC֖Џf1x MBIN*as*' 02I $UwEpz15!8V.*6F8#Rn;
C*}n G`;҇8{t֦M }8F{
N+aŊQIT;A}A윌 ǩ4܌v 6m /q t ~56Di"8+?&?_j
6Vi93.0 L++t*)ܔ6G- ?S.8^p=|=
nYd`6X)^<[MikBFzv ;=>I-v ]i8# bzc t^ o{A XчU$# TT93vT-ʃcpl
SƪQKEЕ~guk
S= 0Wۭ+kU zHA 3J_'9NTҿŠ0
aspqqZ Bǁi^i& ڤoCT]0Buß. \)Ј{l ` ~yuW-rV\
p_y^(PaCF6U$97 pGl`c#AWVij3# 6w Oji+{=~z`;jN@VaqGJzR s?Z ٤ 80GT`GKZEAՄ9=p`vSȠ흽ҧ\70v6BTٌP@N,8m8#q?P=:_0
V cڱ݆@*A IyJ]GVOJȈds}Aa $|WCߨkGTs|"2!@'4MX[ PB9)LpGܯ [<~i
;. 4dJ42Jjz.>A ֱO_#;l9:s1O7AxF8 ߗ=;We[yUX qָ1|KBXV0sӌp
ڥ!T $f H-Y99$cHV'XX&Iټ ՝)*m=;R}:6 _'
V\r)9EDxwa9_ö v / lXH!?LZQΗ14d7Q SW;{bb Z~΄;ҴӒl.3ҙhUT ĺuGDiGٸ6xdo, vs#F %F
}v
ྭZj;=Qn|.1# WoxSqT7/b8փgO<ڧFvԇus=\ 8嵇p q V"r1 6?.. v)s&גZ0\K ):cXJ oNn/Nqc H LB\*GPxx
7.ķU);X$: |xtx'9t=i#ݥY4b/ Ab^pHV˷\R Qdq@'4oG`Xu85Q!dtOz|rm:zh{ع p^GNd?AsR*֒a
yVWٮF2O 恑c n$y
c\G? ×zme:bkҤDO8-jmF:(ҏ<Ȼ5|Yi)k#EwUH { l;s_ 7-7Ğ,koچ7
:?X^նrX0
uR* V74bhF*}JKut. )?UoA鬵 oX39'NJ+*\DY\|Xk^1&kzv)X'
si~lX"+&$g0NK~Q[b%?{[^ OaN
4V;jy7>k~#*LR؋O<]vc1[qߴ\+[y`
Kqj⭚MioY@& \ 2X |ݫ OZO+X',=ZtQد ][ =ދi-?© M|G7#|P/
9xΕY ZLX7WKss}mro'2j$*c&qc2WOG(u}Z mGOu,KC,+״m3NѴ{SG[MV;.$A&є:3pƌ]i$s5%O_B]+QmMOլctb䠅3fLcF W%P.l$RWy[lD920 5J5i;tOt35]'o۷Rk6NeZI5,hDw|+Ƶo5KewlX,Bv1S272+Ziu sF>v~TiΟid еUU}8i "V`0 OgZ_jNl;fyC(.Yܪ1cjWb#Jo{ {94o8oMp>g$_auZ[UCgsk^-$t[ݞsZL é5Zm Oln"+eAs*6@T g5>!m.SԼ>&/4MLtE4vQL aWjz/I JSI7--O]R}GWZM5m4H. 0CJ :+դ55Mfk;km3ImfH8MO=|4hJW6 ө+X/ xHݜ,5#Y2'{BR]ɨZ)A3 8anzW\$BQQ_KC
z(ݥ趷3Z߆| iږmn55;Mėq0D{GӴZZd6A01 < h^7- / %-Sz9ܬ^dƝu&~nM j
5Tm 7s xc+ jN*q}r^*RQ[NB->y%%t]GK]kYOn,hSY&P˅Hڽ]Z
|Dի
殓lz'GD5x.mἾhӀo Hw c<g[;xzzTzܚu on4mRH+< R.Fr5J/iEJT}3 *f,/,Xi6^ 'X1[jDlzu +i^xSЃ!Y{Xᛴ~Xi{:z
)#y(:`*>6H5 FS{ScEO``ۆ[ gqJprZ\iy%jr؆ 9^;xJ 9=_] g`\gv peBS rtwKtq~!6fiGMg шָ<ˎ3]J 뗹RJ+Gм,w!Q*_6Mzt|<odI&C;m'(EedMkc!ൻ[:)DsY.Y|f }\iXU(F]bv1U
ǃ OQ4